Skip to main content
POST
/
api
/
end_users
/
{end_user_id_or_heron_id}
/
transactions
Create end user transactions (async)
curl --request POST \
  --url https://app.herondata.io/api/end_users/{end_user_id_or_heron_id}/transactions \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "transactions": [
    {
      "account_id": "checking_account_202348",
      "amount": -42.42,
      "currency": "USD",
      "description": "GOOGLE *ADS12340929 [email protected] US",
      "reference_id": "my_favourite_transaction_231098",
      "balance": 423,
      "categories_default": "shopping",
      "date": "2020-04-27",
      "mcc_code": "<string>",
      "order": 123,
      "timestamp": "2021-11-12T10:38:05Z",
      "transaction_code": "card"
    }
  ],
  "balances": [
    {
      "account_id": "checking_account_202348",
      "batch_closing_balance": 25000.45
    }
  ]
}
'
{
  "request_id": "<string>",
  "transactions_loaded": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.herondata.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
end_user_id_or_heron_id
string
required

Body

application/json
​
transactions
object[]
required
Minimum array length: 1
​
balances
object[] | null

Bank account balance information for a particular account_id. The balance here must be the latest balance after all the transactions in this batch have been applied.

Response

201 - application/json

OK

​
request_id
string

Unique UUID per request

​
transactions_loaded
integer

The number of transactions loaded