Skip to main content
Get Enrichment Results
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"
  }
}

Authorizations

Authorization
string
header
required

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.

Headers

sub-application
string<uuid>

The sub-application ID to which event type is being subscribed to

Path Parameters

categorisationId
string
required

Unique identifier for transaction categorisation request

Query Parameters

limit
integer<int32>

Optional. The maximum number of transaction records to be returned. Must be between 100 and 1000. If not specified will default to 100.

Required range: 100 <= x <= 1000
page
integer<int32>

Optional. The page number to be returned. If not specified will default to 1.

Required range: x >= 1

Response

OK

meta
object
data
object