Sign in

v1

latestOpenAPI 3.0.02026-07-2412592575.3 KB
transactions

Create multiple transactions for a user

Requires transactions:read:all and transactions:write:all scopes. A maximum of 50 transactions is imposed.

post/transactions-collection

Query parameters

categoriseboolean

Enable categorisation of transactions

Request body

accountIdstring required

The id of the account the transaction belongs to

categoryIdstring required

The category id. Standard categories are prefixed with 'std', custom categories are prefixed with 'cus'

categoryIdConfirmedboolean

Flag indicating whether the user has confirmed the category id as correct

datestring date-time required

The date that the transaction occurred. Where available this will contain an accurate time, where the time is not available it will default to midday.

longDescriptionstring required

The full text description of the transactions - often as it is represented on the users bank statement

shortDescriptionstring

A cleaned up and shorter description of the transaction, this can be edited

notesstring

Arbitrary text that a user can add about a transaction

status'posted' | 'pending'

Whether the transaction has been posted (booked) or is still a pending transaction. During the transition from pending to posted the description will normally change.

projectIdstring

The project ID the transaction is associated with

Example request

[
  {
    "accountId": "c390a94f-2309-4cdf-8d02-b0c5304d9f66",
    "amount": {
      "value": -4500
    },
    "categoryId": "std:4b0255f0-0309-4509-9e05-4b4e386f9b0d",
    "categoryIdConfirmed": true,
    "longDescription": "Long description 1",
    "shortDescription": "description 1",
    "notes": "notes",
    "status": "posted",
    "date": "2018-07-10T12:00:00+00:00"
  },
  {
    "accountId": "c390a94f-2309-4cdf-8d02-b0c5304d9f66",
    "amount": {
      "value": 7800
    },
    "categoryId": "std:4b0255f0-0309-4509-9e05-4b4e386f9b0d",
    "longDescription": "Long description 2",
    "notes": "notes",
    "status": "pending",
    "date": "2018-07-10T12:00:00+00:00"
  }
]

Response

Successful Transaction Response

metaobject

Example response

{
  "data": [
    {
      "id": "c390a94f-3824-4cdf-8d02-b0c5304d9f66"
    }
  ]
}