curl --request GET \
--url https://api.yapily.com/transactions/categorisation/{categorisationId} \
--header 'Authorization: Basic <encoded-value>'{
"meta": {
"tracingId": "string",
"count": 1,
"pageCount": 1
},
"data": {
"transactions": [
{
"enrichment": {
"transactionHash": {
"hash": "6f465bde795b33e497d36333c9a32877.1"
},
"categorisation": {
"categories": [
"refund"
]
},
"merchant": {
"id": "dd0f0493-da4c-1334-50cb-b22ad7327b39",
"name": "Uber",
"logo": "https://example.org/logo.png"
}
},
"recurrence": "one-off",
"paymentProcessor": "PayPal",
"location": "1725 Third Street, San Francisco 94158, United States",
"merchant": {
"merchantCategoryCode": "4121",
"name": "Uber"
},
"id": "236d3792-7014-8f74-53a3-2d600d07840e",
"date": "2026-01-20T09:13:02.752Z",
"bookingDateTime": "2026-01-20T09:13:02.752Z",
"description": "...",
"transactionAmount": {
"amount": 23.87,
"currency": "GBP"
},
"amount": 23.87,
"currency": "GBP",
"status": "BOOKED",
"reference": "...",
"proprietaryBankTransactionCode": {
"code": "REFUND",
"issuer": "bank_id"
},
"isoBankTransactionCode": {
"domainCode": {
"code": "PMNT",
"name": "Payments"
},
"familyCode": {
"code": "RCDT",
"name": "Received Credit Transfers"
},
"subFamilyCode": {
"code": "DMCT",
"name": "Domestic Credit Transfer"
}
}
}
]
},
"links": {
"first": "https://api.yapily.com/accounts/700004000000000000000002/transactions?cursor=aaa",
"prev": "https://api.yapily.com/accounts/700004000000000000000002/transactions?cursor=bbb",
"self": "https://api.yapily.com/accounts/700004000000000000000002/transactions?cursor=ccc",
"next": "https://api.yapily.com/accounts/700004000000000000000002/transactions?cursor=ddd",
"last": "https://api.yapily.com/accounts/700004000000000000000002/transactions?cursor=zzz"
}
}Retrieve categorised transactions by Categorisation ID.
Please use webhooks to be notified when your transactions have been categorised and are ready for retrieval.
Note that when using the Transactions and Categorisation endpoint this endpoint may also return any data specified by the Get Account Transactions endpoint; this endpoint’s docs mentions a non-exhaustive subset of such data.
curl --request GET \
--url https://api.yapily.com/transactions/categorisation/{categorisationId} \
--header 'Authorization: Basic <encoded-value>'{
"meta": {
"tracingId": "string",
"count": 1,
"pageCount": 1
},
"data": {
"transactions": [
{
"enrichment": {
"transactionHash": {
"hash": "6f465bde795b33e497d36333c9a32877.1"
},
"categorisation": {
"categories": [
"refund"
]
},
"merchant": {
"id": "dd0f0493-da4c-1334-50cb-b22ad7327b39",
"name": "Uber",
"logo": "https://example.org/logo.png"
}
},
"recurrence": "one-off",
"paymentProcessor": "PayPal",
"location": "1725 Third Street, San Francisco 94158, United States",
"merchant": {
"merchantCategoryCode": "4121",
"name": "Uber"
},
"id": "236d3792-7014-8f74-53a3-2d600d07840e",
"date": "2026-01-20T09:13:02.752Z",
"bookingDateTime": "2026-01-20T09:13:02.752Z",
"description": "...",
"transactionAmount": {
"amount": 23.87,
"currency": "GBP"
},
"amount": 23.87,
"currency": "GBP",
"status": "BOOKED",
"reference": "...",
"proprietaryBankTransactionCode": {
"code": "REFUND",
"issuer": "bank_id"
},
"isoBankTransactionCode": {
"domainCode": {
"code": "PMNT",
"name": "Payments"
},
"familyCode": {
"code": "RCDT",
"name": "Received Credit Transfers"
},
"subFamilyCode": {
"code": "DMCT",
"name": "Domestic Credit Transfer"
}
}
}
]
},
"links": {
"first": "https://api.yapily.com/accounts/700004000000000000000002/transactions?cursor=aaa",
"prev": "https://api.yapily.com/accounts/700004000000000000000002/transactions?cursor=bbb",
"self": "https://api.yapily.com/accounts/700004000000000000000002/transactions?cursor=ccc",
"next": "https://api.yapily.com/accounts/700004000000000000000002/transactions?cursor=ddd",
"last": "https://api.yapily.com/accounts/700004000000000000000002/transactions?cursor=zzz"
}
}Use HTTP Basic Authentication with your Application ID as username and Application Secret as password. Manage credentials in the Yapily Console. See Authentication for details.
The sub-application ID to which event type is being subscribed to
Unique identifier for transaction categorisation request
Optional. The maximum number of transaction records to be returned. Must be between 100 and 1000. If not specified will default to 100.
100 <= x <= 1000Optional. The page number to be returned. If not specified will default to 1.
x >= 1Was this page helpful?