--- title: "Get Card Transactions" method: GET path: "/cards/{id}/transactions" --- # Get Card Transactions `GET /cards/{id}/transactions` Fetches all transactions for a specific card according to the query parameters. ## Path parameters - `id` string, required ## Query parameters - `page` integer - `limit` integer - `fromDate` string, date - `toDate` string, date ## Response `200` Transactions fetched successfully. - object - `statusCode` integer — Status code of the response. `200` indicates a successful request. - `message` string — Human-readable description of the result. - `data` object[] — Array of objects for the requested page. - `_id` string — Unique identifier of the object. - `business` string — Identifier of the business that owns this object. - `customer` object — Associated customer — an id, or a summary object on nested resources. - `_id` string — Unique identifier of the object. - `business` string — Identifier of the business that owns this object. - `type` string — Type of the object. - `name` string — Display name. - `phoneNumber` string — Customer's phone number in international format. - `emailAddress` string — Customer's email address. - `status` string — Current status of the object. - `individual` object — Details for an individual customer. - `firstName` string — First name. - `lastName` string — Last name. - `otherNames` string — Other names, if any. - `dob` string, date-time — Date of birth (YYYY/MM/DD). - `identity` object — Customer's verified identity record. - `type` string — Type of the object. - `number` string — Identity / card number value. - `billingAddress` object — Customer's billing address. - `line1` string — Address line 1. - `line2` string — Address line 2. - `city` string — City. - `state` string — State / region. - `postalCode` string — Postal / ZIP code. - `country` string — Country. - `isDeleted` boolean — Whether the object has been soft-deleted. - `createdAt` string, date-time — ISO 8601 timestamp of when the object was created. - `updatedAt` string, date-time — ISO 8601 timestamp of when the object was last updated. - `__v` integer — Internal document version (Mongo). - `account` object — Associated account — an id, or a summary object on nested resources. - `_id` string — Unique identifier of the object. - `business` string — Identifier of the business that owns this object. - `type` string — Type of the object. - `currency` string — ISO 4217 currency code (e.g. `NGN`). - `accountName` string — Name on the account. - `bankCode` string — Bank / institution code. - `accountType` string — Account product type (`Savings` or `Current`). - `accountNumber` string — Account number (NUBAN). - `currentBalance` integer — Current ledger balance, in the minor currency unit. - `availableBalance` integer — Balance available for spending, in the minor currency unit. - `provider` string — Underlying provider backing the object. - `providerReference` string - `referenceCode` string - `reloadable` boolean - `isDefault` boolean - `isDeleted` boolean — Whether the object has been soft-deleted. - `createdAt` string, date-time — ISO 8601 timestamp of when the object was created. - `updatedAt` string, date-time — ISO 8601 timestamp of when the object was last updated. - `charges` unknown[] - unknown - `__v` integer — Internal document version (Mongo). - `card` object — Associated card — an id, or a summary object on nested resources. - `failedTransactionCount` integer - `minimumBalance` integer - `version` string - `_id` string — Unique identifier of the object. - `business` string — Identifier of the business that owns this object. - `customer` string — Associated customer — an id, or a summary object on nested resources. - `account` string — Associated account — an id, or a summary object on nested resources. - `fundingSource` string — Identifier of the funding source backing this object. - `program` unknown - `type` string — Type of the object. - `brand` string — Card scheme/brand (e.g. `Verve`, `MasterCard`). - `currency` string — ISO 4217 currency code (e.g. `NGN`). - `maskedPan` string — Masked card number (PAN). - `expiryMonth` string — Card expiry month (MM). - `expiryYear` string — Card expiry year (YYYY). - `status` string — Current status of the object. - `is2FAEnabled` boolean - `is2FAEnrolled` boolean — Whether the card is enrolled for 3-D Secure / 2FA. - `isDefaultPINChanged` boolean — Whether the default PIN has been changed. - `disposable` boolean — Whether the card is single-use / disposable. - `refundAccount` unknown - `providerReference` string - `isDigitalized` boolean - `accumulatedFees` integer - `totalFeesCharged` integer - `feeChargeDay` integer - `isDeleted` boolean — Whether the object has been soft-deleted. - `createdAt` string, date-time — ISO 8601 timestamp of when the object was created. - `updatedAt` string, date-time — ISO 8601 timestamp of when the object was last updated. - `__v` integer — Internal document version (Mongo). - `spendingControls` object — Spending limits and channel/category controls applied to the card. - `channels` object — Channels through which the card may be used. - `atm` boolean — Whether ATM usage is allowed. - `pos` boolean — Whether POS usage is allowed. - `web` boolean — Whether web/online usage is allowed. - `mobile` boolean — Whether mobile usage is allowed. - `allowedCategories` unknown[] — Merchant category codes (MCC) explicitly allowed. - unknown - `blockedCategories` unknown[] — Merchant category codes (MCC) explicitly blocked. - unknown - `spendingLimits` unknown[] — Configured spending limits. - unknown - `authorization` object — Identifier of the authorization this transaction belongs to. - `_id` string — Unique identifier of the object. - `business` string — Identifier of the business that owns this object. - `customer` string — Associated customer — an id, or a summary object on nested resources. - `account` string — Associated account — an id, or a summary object on nested resources. - `card` string — Associated card — an id, or a summary object on nested resources. - `amount` number — Amount in the minor currency unit (e.g. kobo). - `fee` integer — Fee charged, in the minor currency unit. - `vat` number — VAT charged, in the minor currency unit. - `approved` boolean — Whether the authorization was approved. - `currency` string — ISO 4217 currency code (e.g. `NGN`). - `status` string — Current status of the object. - `authorizationMethod` string — How the authorization was performed. - `balanceTransactions` unknown[] - unknown - `merchantAmount` integer — Amount in the merchant's currency. - `merchantCurrency` string — Merchant's ISO 4217 currency code. - `merchant` object - `category` string - `name` string — Display name. - `merchantId` string - `city` string — City. - `state` string — State / region. - `country` string — Country. - `postalCode` string — Postal / ZIP code. - `terminal` object - `rrn` string - `stan` string - `terminalId` string - `terminalOperatingEnvironment` string - `terminalAttendance` string - `terminalType` string - `panEntryMode` string - `pinEntryMode` string - `cardHolderPresence` boolean - `cardPresence` boolean - `transactionMetadata` object — Channel and reference metadata for the transaction. - `channel` string — Channel the transaction occurred on (`web`, `pos`, `atm`). - `type` string — Type of the object. - `reference` string — Unique reference assigned to the object. - `pendingRequest` unknown - `requestHistory` object[] - `amount` number — Amount in the minor currency unit (e.g. kobo). - `currency` string — ISO 4217 currency code (e.g. `NGN`). - `approved` boolean — Whether the authorization was approved. - `merchantAmount` integer — Amount in the merchant's currency. - `merchantCurrency` string — Merchant's ISO 4217 currency code. - `reason` string — Reason for the dispute. - `createdAt` string, date-time — ISO 8601 timestamp of when the object was created. - `verification` object - `billingAddressLine1` string - `billingAddressPostalCode` string - `cvv` string - `expiry` string - `pin` string - `threeDSecure` string - `safeToken` string - `authentication` string - `isDeleted` boolean — Whether the object has been soft-deleted. - `createdAt` string, date-time — ISO 8601 timestamp of when the object was created. - `updatedAt` string, date-time — ISO 8601 timestamp of when the object was last updated. - `feeDetails` object[] - `contract` string - `currency` string — ISO 4217 currency code (e.g. `NGN`). - `amount` integer — Amount in the minor currency unit (e.g. kobo). - `description` string — Description text. - `__v` integer — Internal document version (Mongo). - `amount` number — Amount in the minor currency unit (e.g. kobo). - `fee` integer — Fee charged, in the minor currency unit. - `vat` number — VAT charged, in the minor currency unit. - `currency` string — ISO 4217 currency code (e.g. `NGN`). - `type` string — Type of the object. - `balanceTransactions` unknown[] - unknown - `merchantAmount` integer — Amount in the merchant's currency. - `merchantCurrency` string — Merchant's ISO 4217 currency code. - `merchant` object - `category` string - `name` string — Display name. - `merchantId` string - `city` string — City. - `state` string — State / region. - `country` string — Country. - `postalCode` string — Postal / ZIP code. - `terminal` object - `rrn` string - `stan` string - `terminalId` string - `terminalOperatingEnvironment` string - `terminalAttendance` string - `terminalType` string - `panEntryMode` string - `pinEntryMode` string - `cardHolderPresence` boolean - `cardPresence` boolean - `transactionMetadata` object — Channel and reference metadata for the transaction. - `channel` string — Channel the transaction occurred on (`web`, `pos`, `atm`). - `type` string — Type of the object. - `reference` string — Unique reference assigned to the object. - `isDeleted` boolean — Whether the object has been soft-deleted. - `createdAt` string, date-time — ISO 8601 timestamp of when the object was created. - `updatedAt` string, date-time — ISO 8601 timestamp of when the object was last updated. - `feeDetails` object[] - `contract` string - `currency` string — ISO 4217 currency code (e.g. `NGN`). - `amount` integer — Amount in the minor currency unit (e.g. kobo). - `description` string — Description text. - `__v` integer — Internal document version (Mongo). - `pagination` object — Pagination metadata for the result set. - `total` integer — Total number of records matching the query across all pages. - `pages` integer — Total number of pages available for the current query. - `page` integer — Current page index (zero-based; matches the `page` query parameter). - `limit` integer — Maximum number of records returned per page (matches the `limit` query parameter). ## Other responses - `400` — Validation error. - `401` — Authentication failed — missing or invalid API key. --- [API](https://skmtc.net/sudo/apis/sudo-sandbox-api.md) · [All operations](https://skmtc.net/sudo/apis/sudo-sandbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sudo/sudo-sandbox-api/versions/52be624fcb53/schema)