curl --request GET \
--url https://api.yapily.com/accounts/{accountId}/transactions/categorisation/{categorisationId} \
--header 'Authorization: Basic <encoded-value>' \
--header 'consent: <consent>'{
"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"
}
}Deprecated. Retrieve categorised transactions by Categorisation ID.
Use the other endpoint (/transactions/categorisation/{categorisationId}) instead.
curl --request GET \
--url https://api.yapily.com/accounts/{accountId}/transactions/categorisation/{categorisationId} \
--header 'Authorization: Basic <encoded-value>' \
--header 'consent: <consent>'{
"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.
Mandatory. The consent-token containing the user's authorisation to make the request.
The sub-application ID to which event type is being subscribed to
Unique identifier for account
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?