Get card transactions

Endpoint

POST /{san}/transactions

Path parameters

• san — Unique card identifier in the CinCin system

Request

Content-Type: application/json

Request body

Request (application/json)

{
  "page": 0,
  "size": 20,
  "from": "2026-01-01T00:00:00.000Z",
  "to": "2026-02-04T23:59:59.999Z"
}

Request parameters

• *page (number) — Page number (0-based)

• *size (number) — Number of transactions per page

• from (string ISO 8601) — Start date for filtering

• to (string ISO 8601) — End date for filtering

Response

{
  "total": 6,
  "list": [
    {
      "date": "2025-07-30T13:59:53Z",
      "authorizationCode": null,
      "transactionId": "9970-9e3a45af47e3-84c0-d632-c771-6992",
      "isForcePost": false,
      "transactionSum": 1.35,
      "transactionCommission": 0.25,
      "cardCurrency": "USD",
      "transactionRecipient": "GGGG.COM [phone] US",
      "merchantCategory": null,
      "id": "b129883e-1e2c-43a3-87db-116b4c3151c7",
      "transactionValue": 1.1,
      "declineReason": null,
      "status": "expense"
    }
  ]
}

Response parameters

• total (number) — Total number of transactions matching the query

• list (array) — Array of transaction objects

• list[].date (string ISO 8601) — Transaction date and time in UTC

• list[].authorizationCode (string, null) — Authorization code for the transaction (if available)

• list[].transactionId (string) — Unique transaction identifier

• list[].isForcePost (boolean) — Indicates if the transaction was force-posted

• list[].transactionSum (decimal) — Total transaction amount including commission

• list[].transactionCommission (decimal) — Commission fee charged for the transaction

• list[].cardCurrency (string) — Currency code

• list[].transactionRecipient (string) — Merchant name and location information

• list[].merchantCategory (string, null) — Merchant Category Code (MCC) if available

• list[].id (string UUID) — Internal transaction record identifier

• list[].transactionValue (decimal) — Transaction amount before commission

• list[].declineReason — Reason for decline if transaction was declined

• list[].status (string) — Transaction status

Transaction status enum list

• pending — Transaction authorization pending

• expense — Completed expense/purchase transaction

• cancellation — Transaction declined or cancelled

• hold — Amount held pending completion

• hold (refund) — Amount held for refund processing

• refund — Refund transaction completed

• reversal — Transaction reversed

• atm — ATM cash withdrawal