GET /transactions
Lists all transactions for the workspace
curl -X GET "https://api.us-west-2.fragment.dev/transactions" \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json"{
"data": [
{
"id": "txn_dHhuX2ZyYWdfMDAx",
"external_id": "bank_txn_123",
"account": {
"id": "ext_account_YWJjMTIz",
"external_id": "acct_external_123"
},
"posted": "2026-02-12T00:00:00.000Z",
"currency": "USD",
"amount": "-1000",
"allocations": [
{
"invoice_id": "inv_abc123",
"amount": "1000",
"type": "invoice_payin"
}
],
"unallocated_amount": "-1000",
"created": "2026-02-12T00:00:00.000Z",
"modified": "2026-02-12T01:00:00.000Z"
}
]
}| Name | Description |
|---|---|
| reconciliation_status - string | Filter by reconciliation state. reconciled = unallocated_amount === 0; unreconciled = unallocated_amount !== 0. Omit for all transactions. |
| account - string | Filter by account. Encoded account ID (ext_account_xxx) or external_id. If the account does not exist, returns an empty list. |
POST /transactions
Syncs a transaction, optionally with allocations
curl -X POST "https://api.us-west-2.fragment.dev/transactions" \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"external_id":"bank_txn_123","account":{"id":"ext_account_YWJjMTIz","external_id":"acct_external_123"},"posted":"2026-02-12T00:00:00.000Z","currency":"USD","amount":"-1000","allocations":[]}'{
"data": {
"id": "txn_dHhuX2ZyYWdfMDAx",
"external_id": "bank_txn_123",
"account": {
"id": "ext_account_YWJjMTIz",
"external_id": "acct_external_123"
},
"posted": "2026-02-12T00:00:00.000Z",
"currency": "USD",
"amount": "-1000",
"allocations": [
{
"invoice_id": "inv_abc123",
"amount": "1000",
"type": "invoice_payin"
}
],
"unallocated_amount": "-1000",
"created": "2026-02-12T00:00:00.000Z",
"modified": "2026-02-12T01:00:00.000Z"
}
}| Name | Description |
|---|---|
| external_id (required) - string | External transaction ID used for idempotent sync. |
| account (required) - object | Account reference. Provide id, external_id, or both. |
| posted (required) - string | Posted timestamp in ISO 8601 format. |
| currency (required) - string | Currency code (ISO 4217 or crypto) |
| amount (required) - string | Amount in smallest currency unit as stringified bigint (can be positive or negative). |
| allocations (required) - array | Allocation entries for this transaction. Empty indicates unreconciled funds. |
GET /transactions/{id}
Gets a transaction by ID
curl -X GET "https://api.us-west-2.fragment.dev/transactions/inv_123" \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json"{
"data": {
"id": "txn_dHhuX2ZyYWdfMDAx",
"external_id": "bank_txn_123",
"account": {
"id": "ext_account_YWJjMTIz",
"external_id": "acct_external_123"
},
"posted": "2026-02-12T00:00:00.000Z",
"currency": "USD",
"amount": "-1000",
"allocations": [
{
"invoice_id": "inv_abc123",
"amount": "1000",
"type": "invoice_payin"
}
],
"unallocated_amount": "-1000",
"created": "2026-02-12T00:00:00.000Z",
"modified": "2026-02-12T01:00:00.000Z"
}
}| Name | Description |
|---|---|
| {id} (required) - string | - |