Fund Transfer
Fund Transfers is used to move money, assets or funds between the balance sheet accounts. It allows you to transfer funds between similar but different accounts, e.g., from a checking account to a petty cash account or from a savings account to your checking account. Fund Transfers object allows you to perform the following operations:
- Retrieve a specific fund transfer or a list of fund transfers
- Create a fund transfer
- Update a fund transfer
- Delete a fund transfer
- cURL
- NODE.JS
- PHP
- C#
- PYTHON
- JAVA
The Fund Transfer Object
asterisk denotes required| Name | Description | Format | Attributes |
|---|---|---|---|
| amount | Represents the fund transfer amount | double | Filterable, Sortable |
| date | Represents the date of the fund transfer | date-time | Filterable, Sortable |
| destinationId | Identifier of the account to which funds are transferred | uuid | Filterable, Sortable |
| sourceId | Identifier of the account from which funds are transferred | uuid | Filterable, Sortable |
| accountingDate | Date that determines the accounting period to which the transaction belongs in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time | |
| createdById | Identifier of the user who created this object | uuid | Filterable |
| createdOn | Date and time when this object was created (UTC Now), in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time | Filterable, Sortable |
| customFields []Array: Parent object can have multiple instances of this nested object under it. | List of custom fields | CustomFieldData Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter. | |
| destinationAccount | Name of the account to which funds are transferred | string | Filterable, Sortable |
| id | Object identifier | uuid | Filterable |
| lastUpdated | Last updated date and time value of this object in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time | Filterable, Sortable |
| lastUpdatedById | Identifier of the user who last updated this object | uuid | Filterable |
| memo | Records any extra information against a fund transfer for recapitulation | string | |
| objectState | Represents the state of the object. e.g., new, unchanged, modified or deleted | ObjectState Enumerated type: Click to see possible values and their descriptions. | |
| sourceAccount | Name of the account from which funds are transferred | string | Filterable, Sortable |
| token | Represents the token for update operations | int32 | |
| version | Implements concurrency on this object | byte |
Fund Transfer List
Use this method to retrieve a list of fund transfers. You can optionally pass where, orderBy, and page as query parameters to filter the result. Use the fields parameter to request a subset of the model. By default, a complete model is returned. The expand parameter is used to request nested properties in the model.
Request URL
Method Overview
HTTP Method:
GET
Content Type:
application/json
Response Format:
json
Requires Authentication?
Yes
Headers:
Module:
Fund Transfer
Required Scopes:
read:core
Required Subscription:
View Subscription
Request Parameters asterisk denotes required
| Name | Parameter Type | Description | Format |
|---|---|---|---|
| fields | Query | Specifies the model properties you want in the response body | string |
| where | Query | Specifies only those records that match an expression in the query | string |
| orderBy | Query | Specifies the order of the records | string |
| page | Query | Specifies the page number and number of records on each page | string |
| expand | Query | Specifies the nested model properties you want in the response body | string |
Response Body
| Name | Description | Format |
|---|---|---|
| amount | Represents the fund transfer amount | double |
| date | Represents the date of the fund transfer | date-time |
| destinationId | Identifier of the account to which funds are transferred | uuid |
| sourceId | Identifier of the account from which funds are transferred | uuid |
| accountingDate | Date that determines the accounting period to which the transaction belongs in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
| createdById | Identifier of the user who created this object | uuid |
| createdOn | Date and time when this object was created (UTC Now), in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
| customFields []Array: Parent object can have multiple instances of this nested object under it. | List of custom fields | CustomFieldData Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter. |
| destinationAccount | Name of the account to which funds are transferred | string |
| id | Object identifier | uuid |
| lastUpdated | Last updated date and time value of this object in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
| lastUpdatedById | Identifier of the user who last updated this object | uuid |
| memo | Records any extra information against a fund transfer for recapitulation | string |
| objectState | Represents the state of the object. e.g., new, unchanged, modified or deleted | ObjectStateEnumerated type: Click to see possible values and their descriptions. |
| sourceAccount | Name of the account from which funds are transferred | string |
| token | Represents the token for update operations | int32 |
| version | Implements concurrency on this object | byte |
[
{
"amount": 1,
"date": "2026-01-14T04:56:22Z",
"destinationId": "e252a050-5b2b-49d3-b96f-19eb2faab275",
"sourceId": "5579576d-3319-4786-b84a-789c77bb0010",
"accountingDate": "2026-01-14T04:56:22Z",
"createdById": "77c3c4e7-46d7-4396-bc58-4c558ba1a9f0",
"createdOn": "2026-01-14T04:56:22Z",
"customFields": [
{
"definitionId": "eda6a640-ad8d-4b1d-b191-8a174d31d461",
"createdById": "4f960f6b-4b83-4d62-af49-71163df7bd6f",
"createdOn": "2026-01-14T04:56:22Z",
"description": "CustomFieldData Description",
"id": "c947cb32-1518-4263-9afc-8867cb450b13",
"label": "label",
"lastUpdated": "2026-01-14T04:56:22Z",
"lastUpdatedById": "6355d54b-d348-4ec0-b859-c43a52a1f697",
"objectState": null,
"token": 0,
"type": null,
"value": "value",
"version": "U3dhZ2dlciByb2Nrcw=="
}
],
"destinationAccount": "destinationAccount",
"id": "608c6b22-537a-4f54-8d7b-32fddfa61a67",
"lastUpdated": "2026-01-14T04:56:22Z",
"lastUpdatedById": "20a2b5cb-2a7d-40b6-944a-f81d1823a2b3",
"memo": "memo",
"objectState": null,
"sourceAccount": "sourceAccount",
"token": 0,
"version": "U3dhZ2dlciByb2Nrcw=="
}
]Retrieve a Fund Transfer
Use this method to retrieve a specific fund transfer. Pass id as the parameter.
Request URL
Method Overview
HTTP Method:
GET
Content Type:
application/json
Response Format:
json
Requires Authentication?
Yes
Headers:
Module:
Fund Transfer
Required Scopes:
read:core
Required Subscription:
View Subscription
Request Parameters asterisk denotes required
| Name | Parameter Type | Description | Format |
|---|---|---|---|
| id | Path | Fund Transfer identifier | string |
Response Body
| Name | Description | Format |
|---|---|---|
| amount | Represents the fund transfer amount | double |
| date | Represents the date of the fund transfer | date-time |
| destinationId | Identifier of the account to which funds are transferred | uuid |
| sourceId | Identifier of the account from which funds are transferred | uuid |
| accountingDate | Date that determines the accounting period to which the transaction belongs in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
| createdById | Identifier of the user who created this object | uuid |
| createdOn | Date and time when this object was created (UTC Now), in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
| customFields []Array: Parent object can have multiple instances of this nested object under it. | List of custom fields | CustomFieldData Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter. |
| destinationAccount | Name of the account to which funds are transferred | string |
| id | Object identifier | uuid |
| lastUpdated | Last updated date and time value of this object in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
| lastUpdatedById | Identifier of the user who last updated this object | uuid |
| memo | Records any extra information against a fund transfer for recapitulation | string |
| objectState | Represents the state of the object. e.g., new, unchanged, modified or deleted | ObjectStateEnumerated type: Click to see possible values and their descriptions. |
| sourceAccount | Name of the account from which funds are transferred | string |
| token | Represents the token for update operations | int32 |
| version | Implements concurrency on this object | byte |
{
"amount": 1,
"date": "2026-01-14T04:56:22Z",
"destinationId": "32c3c43d-7afc-44e1-9df5-5e6525870470",
"sourceId": "2548456c-3074-44ea-a968-d9b2a4664312",
"accountingDate": "2026-01-14T04:56:22Z",
"createdById": "41f18437-10fb-4a29-866c-f1b7205d9b84",
"createdOn": "2026-01-14T04:56:22Z",
"customFields": [
{
"definitionId": "3853d0c3-3a4b-49a1-8230-c28731159ec0",
"createdById": "ef8441d5-d85d-46c4-9394-7b132fe8b150",
"createdOn": "2026-01-14T04:56:22Z",
"description": "CustomFieldData Description",
"id": "4f2997e8-653c-443c-8155-e304823f9cb5",
"label": "label",
"lastUpdated": "2026-01-14T04:56:22Z",
"lastUpdatedById": "e4c41571-9b20-4de0-9745-cd746393f9a3",
"objectState": null,
"token": 0,
"type": null,
"value": "value",
"version": "U3dhZ2dlciByb2Nrcw=="
}
],
"destinationAccount": "destinationAccount",
"id": "aba5219f-4efc-44c7-82df-6217c6ed0db0",
"lastUpdated": "2026-01-14T04:56:22Z",
"lastUpdatedById": "01d812a0-8b9b-493e-88be-cdd477006bff",
"memo": "memo",
"objectState": null,
"sourceAccount": "sourceAccount",
"token": 0,
"version": "U3dhZ2dlciByb2Nrcw=="
}Create a Fund Transfer
Use this method to craete a fund transfer. Pass fund transfer object as the parameter.
Request URL
Method Overview
HTTP Method:
POST
Content Type:
application/json
Response Format:
json
Requires Authentication?
Yes
Headers:
Module:
Fund Transfer
Required Scopes:
readwrite:core
Required Subscription:
View Subscription
Request Parameters asterisk denotes required
| Name | Parameter Type | Description | Format |
|---|---|---|---|
| body | Body | Fund Transfer object | FundTransfer |
Response Body
| Name | Description | Format |
|---|---|---|
| amount | Represents the fund transfer amount | double |
| date | Represents the date of the fund transfer | date-time |
| destinationId | Identifier of the account to which funds are transferred | uuid |
| sourceId | Identifier of the account from which funds are transferred | uuid |
| accountingDate | Date that determines the accounting period to which the transaction belongs in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
| createdById | Identifier of the user who created this object | uuid |
| createdOn | Date and time when this object was created (UTC Now), in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
| customFields []Array: Parent object can have multiple instances of this nested object under it. | List of custom fields | CustomFieldData Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter. |
| destinationAccount | Name of the account to which funds are transferred | string |
| id | Object identifier | uuid |
| lastUpdated | Last updated date and time value of this object in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
| lastUpdatedById | Identifier of the user who last updated this object | uuid |
| memo | Records any extra information against a fund transfer for recapitulation | string |
| objectState | Represents the state of the object. e.g., new, unchanged, modified or deleted | ObjectStateEnumerated type: Click to see possible values and their descriptions. |
| sourceAccount | Name of the account from which funds are transferred | string |
| token | Represents the token for update operations | int32 |
| version | Implements concurrency on this object | byte |
{
"amount": 1,
"date": "2026-01-14T04:56:22Z",
"destinationId": "a9f8705d-e90e-4cc1-9a9e-a11465a942a1",
"sourceId": "dbff4af4-8d5c-46d3-8255-23e8609b0516",
"accountingDate": "2026-01-14T04:56:22Z",
"createdById": "1651e8ff-044d-465b-bff1-93401f57046d",
"createdOn": "2026-01-14T04:56:22Z",
"customFields": [
{
"definitionId": "5a3c5d8a-34af-4b82-b7b8-68da06f0bdb5",
"createdById": "17b93ade-5490-476a-8f21-eb7a0fc19420",
"createdOn": "2026-01-14T04:56:22Z",
"description": "CustomFieldData Description",
"id": "d95d6789-b984-4bfb-a48f-932acf48c119",
"label": "label",
"lastUpdated": "2026-01-14T04:56:22Z",
"lastUpdatedById": "a40e4769-99cc-47a9-a6ea-3bd5de4caf5d",
"objectState": null,
"token": 0,
"type": null,
"value": "value",
"version": "U3dhZ2dlciByb2Nrcw=="
}
],
"destinationAccount": "destinationAccount",
"id": "6b9ce6dc-b1b3-4f49-a78f-4391b82bc3c0",
"lastUpdated": "2026-01-14T04:56:22Z",
"lastUpdatedById": "86c2a348-b45f-4470-8b4c-0be36ebc6678",
"memo": "memo",
"objectState": null,
"sourceAccount": "sourceAccount",
"token": 0,
"version": "U3dhZ2dlciByb2Nrcw=="
}Create a Fund Transfer List
Use this method to save multiple fund transfers. Pass model as the parameter.
As saving multiple records in a batch takes time, this endpoint returns a Job object that shows the progress of the batch operation. To check the status of the operation at any time, use the job endpoint.
Request URL
Method Overview
HTTP Method:
POST
Content Type:
application/json
Response Format:
json
Requires Authentication?
Yes
Headers:
Module:
Fund Transfer
Required Scopes:
readwrite:core
Required Subscription:
View Subscription
Request Parameters asterisk denotes required
| Name | Parameter Type | Description | Format |
|---|---|---|---|
| body | Body | Fund Transfer object | FundTransferBatchRequest |
Response Body
| Name | Description | Format |
|---|---|---|
| batchSize | Represents the number of entities in a batch | int64 |
| createdById | Identifier of the user who created this object | uuid |
| createdOn | Date and time when this object was created (UTC Now), in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
| id | Object identifier | uuid |
| lastUpdated | Last updated date and time value of this object in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
| lastUpdatedById | Identifier of the user who last updated this object | uuid |
| objectState | Represents the state of the object. e.g., new, unchanged, modified or deleted | ObjectStateEnumerated type: Click to see possible values and their descriptions. |
| progress | Represents the total number of entities processed | int64 |
| status | Represents the status of a job e.g., ready, running, completed, or terminated | string |
| token | Represents the token for update operations | int32 |
| type | Represents the type of a job e.g., create, update, or delete | string |
| version | Implements concurrency on this object | byte |
{
"batchSize": 0,
"createdById": "1943f482-c6b5-4104-b34a-e5262da9ce64",
"createdOn": "2026-01-14T04:56:22Z",
"id": "89f29de2-f9f5-41d3-89b0-bc1cc6611aca",
"lastUpdated": "2026-01-14T04:56:22Z",
"lastUpdatedById": "b8a7adf3-3296-497c-980c-163abba0eb3a",
"objectState": null,
"progress": 0,
"status": "status",
"token": 0,
"type": "type",
"version": "U3dhZ2dlciByb2Nrcw=="
}Update a Fund Transfer
Use this method to update a fund transfer. Pass id and fund transfer as parameters.
Request URL
Method Overview
HTTP Method:
PUT
Content Type:
application/json
Response Format:
json
Requires Authentication?
Yes
Headers:
Module:
Fund Transfer
Required Scopes:
readwrite:core
Required Subscription:
View Subscription
Request Parameters asterisk denotes required
| Name | Parameter Type | Description | Format |
|---|---|---|---|
| id | Path | Fund Transfer identifier | string |
| body | Body | Fund Transfer object | FundTransfer |
Response Body
| Name | Description | Format |
|---|---|---|
| amount | Represents the fund transfer amount | double |
| date | Represents the date of the fund transfer | date-time |
| destinationId | Identifier of the account to which funds are transferred | uuid |
| sourceId | Identifier of the account from which funds are transferred | uuid |
| accountingDate | Date that determines the accounting period to which the transaction belongs in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
| createdById | Identifier of the user who created this object | uuid |
| createdOn | Date and time when this object was created (UTC Now), in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
| customFields []Array: Parent object can have multiple instances of this nested object under it. | List of custom fields | CustomFieldData Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter. |
| destinationAccount | Name of the account to which funds are transferred | string |
| id | Object identifier | uuid |
| lastUpdated | Last updated date and time value of this object in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss | date-time |
| lastUpdatedById | Identifier of the user who last updated this object | uuid |
| memo | Records any extra information against a fund transfer for recapitulation | string |
| objectState | Represents the state of the object. e.g., new, unchanged, modified or deleted | ObjectStateEnumerated type: Click to see possible values and their descriptions. |
| sourceAccount | Name of the account from which funds are transferred | string |
| token | Represents the token for update operations | int32 |
| version | Implements concurrency on this object | byte |
{
"amount": 1,
"date": "2026-01-14T04:56:22Z",
"destinationId": "7f0e58dc-3087-40a1-9223-83746d4f02cb",
"sourceId": "98b2aa0c-1352-4343-b4ce-f37e448e44e9",
"accountingDate": "2026-01-14T04:56:22Z",
"createdById": "8b5ea086-aba9-4e98-ad45-40fc1eeabc0e",
"createdOn": "2026-01-14T04:56:22Z",
"customFields": [
{
"definitionId": "9cd9730e-26eb-40ef-82db-5b460b69fedc",
"createdById": "e2757d3e-3a3a-4e1b-8092-ca0e06704761",
"createdOn": "2026-01-14T04:56:22Z",
"description": "CustomFieldData Description",
"id": "87528e7c-1583-405e-a26f-dfc4442c0dc9",
"label": "label",
"lastUpdated": "2026-01-14T04:56:22Z",
"lastUpdatedById": "1c8565f5-6ad2-40e0-8720-2d0e58186e8f",
"objectState": null,
"token": 0,
"type": null,
"value": "value",
"version": "U3dhZ2dlciByb2Nrcw=="
}
],
"destinationAccount": "destinationAccount",
"id": "fd8b5262-f967-40ca-93af-617503b391b9",
"lastUpdated": "2026-01-14T04:56:22Z",
"lastUpdatedById": "59bb80b6-418d-4ee2-ae49-c5f8e3f1228b",
"memo": "memo",
"objectState": null,
"sourceAccount": "sourceAccount",
"token": 0,
"version": "U3dhZ2dlciByb2Nrcw=="
}Delete a Fund Transfer
Use this method to delete a fund transfer. Pass id as the parameter.
Request URL
Method Overview
HTTP Method:
DELETE
Content Type:
application/json
Response Format:
N/A
Requires Authentication?
Yes
Headers:
Required Scopes:
readwrite:core
Required Subscription:
View Subscription
Request Parameters asterisk denotes required
| Name | Parameter Type | Description | Format |
|---|---|---|---|
| id | Path | Fund Transfer identifier | string |
Patch a Fund Transfer
Use this method to perform partial modifications to a fund transfer. Pass id and patch document as parameters.
Request URL
Method Overview
HTTP Method:
PATCH
Content Type:
application/json
Response Format:
json
Requires Authentication?
Yes
Headers:
Module:
Fund Transfer
Required Scopes:
readwrite:core
Required Subscription:
View Subscription
Request Parameters asterisk denotes required
| Name | Parameter Type | Description | Format |
|---|---|---|---|
| id | Path | Fund Transfer identifier | string |
| body | Body | A document containing an array of objects with each object representing a single operation to be performed | FundTransferPatchDocument |
Response Body
| Name | Description | Format |
|---|