Raw schema
{
"type": "object",
"properties": {
"gift_date": {
"type": "string",
"minLength": 1,
"description": "Gift date, e.g. 2026-09-29."
},
"gift_type": {
"type": "string",
"minLength": 1,
"description": "Gift type as configured in Virtuous, e.g. \"Cash\"."
},
"amount": {
"type": "string",
"minLength": 1,
"description": "Gift amount, e.g. \"100.00\"."
},
"contact": {
"type": "object",
"properties": {
"id": {
"description": "Existing Virtuous contact id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"referenceId": {
"description": "The donor's id in your system.",
"type": "string"
},
"name": {
"type": "string"
},
"type": {
"description": "Contact type, e.g. Household or Organization.",
"type": "string"
},
"title": {
"type": "string"
},
"firstname": {
"type": "string"
},
"middlename": {
"type": "string"
},
"lastname": {
"type": "string"
},
"suffix": {
"type": "string"
},
"emailType": {
"type": "string"
},
"email": {
"type": "string"
},
"phoneType": {
"type": "string"
},
"phone": {
"type": "string"
},
"address": {
"type": "object",
"properties": {
"address1": {
"type": "string"
},
"address2": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"postal": {
"type": "string"
},
"country": {
"type": "string"
}
}
}
},
"description": "The donor. Virtuous matches this against existing contacts."
},
"transaction_source": {
"description": "Where the gift came from, e.g. \"Website\".",
"type": "string"
},
"transaction_id": {
"description": "The gift's id in that source (prevents double import).",
"type": "string"
},
"currency_code": {
"description": "ISO currency code, e.g. USD.",
"type": "string"
},
"frequency": {
"description": "For a recurring gift: its frequency as named in Virtuous.",
"type": "string"
},
"batch": {
"description": "Batch name.",
"type": "string"
},
"notes": {
"type": "string"
},
"segment": {
"description": "Segment code the gift is attributed to.",
"type": "string"
},
"receipt_date": {
"type": "string"
},
"is_private": {
"type": "boolean"
},
"is_tax_deductible": {
"type": "boolean"
},
"check_number": {
"type": "string"
},
"designations": {
"description": "Split the gift across projects.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Project id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"name": {
"description": "Project name.",
"type": "string"
},
"code": {
"description": "Project code.",
"type": "string"
},
"amountDesignated": {
"type": "string",
"description": "Amount designated to this project."
}
},
"required": [
"amountDesignated"
]
}
},
"custom_fields": {
"description": "Custom field name -> value.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
}
},
"required": [
"gift_date",
"gift_type",
"amount",
"contact"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}