> ## Documentation Index > Fetch the complete documentation index at: https://docs.pointzero.io/llms.txt > Use this file to discover all available pages before exploring further. # List transactions > Returns transactions, newest first. ## OpenAPI ````yaml /api-reference/openapi.json get /transactions openapi: 3.0.3 info: title: PointZero Card Issuing API version: 2026-10 description: >- Issue and manage virtual and physical payment cards. All amounts are integers in the smallest currency unit. Requests and responses are JSON. Authenticate with a secret API key in the `Authorization: Bearer` header; keys starting with `sk_test_` work only in the sandbox. List endpoints use cursor pagination with `limit` and `starting_after`. `POST` requests that create resources accept an `Idempotency-Key` header. contact: name: PointZero email: support@pointzero.io url: https://pointzero.io servers: - url: https://api.pointzero.io/v1 description: Production - url: https://sandbox.api.pointzero.io/v1 description: Sandbox security: - bearerAuth: [] tags: - name: Programs description: Card programs configured for your account. - name: Customers description: Individuals and businesses that hold cards. - name: Cards description: Issue and manage the card lifecycle. - name: Authorization Controls description: Merchant, country and channel rules. - name: 3D Secure description: 3DS settings for online payments. - name: Wallets description: Apple Pay and Google Pay tokens. - name: Physical Cards description: Production and delivery of plastic cards. - name: PIN description: PIN management for physical cards. - name: Transactions description: Authorizations, refunds and settlements. - name: Disputes description: Chargebacks on card transactions. paths: /transactions: get: tags: - Transactions summary: List transactions description: Returns transactions, newest first. operationId: listTransactions parameters: - name: card_id in: query schema: type: string - name: customer_id in: query schema: type: string - name: status in: query schema: type: string enum: - authorized - declined - reversed - settled - name: currency in: query schema: type: string pattern: ^[A-Z]{3}$ description: Three-letter ISO 4217 currency code. example: EUR - name: created_gte in: query schema: type: string format: date-time description: Return transactions created at or after this time. - name: created_lt in: query schema: type: string format: date-time description: Return transactions created before this time. - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/StartingAfter' responses: '200': description: OK. content: application/json: schema: $ref: '#/components/schemas/TransactionList' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' components: parameters: Limit: name: limit in: query description: Number of items to return. schema: type: integer minimum: 1 maximum: 100 default: 20 StartingAfter: name: starting_after in: query description: Cursor from `next_cursor` of the previous page. schema: type: string schemas: TransactionList: type: object required: - object - data - has_more properties: object: type: string enum: - list description: Object type. readOnly: true data: type: array items: $ref: '#/components/schemas/Transaction' has_more: type: boolean next_cursor: type: string nullable: true description: Pass as `starting_after` to get the next page. Transaction: type: object required: - id - object - card_id - amount - currency - status - created_at properties: id: type: string description: Unique identifier, prefixed with `txn_`. example: txn_01JZ8P7H2R readOnly: true object: type: string enum: - transaction description: Object type. readOnly: true card_id: type: string example: card_01JZ8N2K4M customer_id: type: string example: cus_01JZ8M4X7K type: type: string enum: - purchase - refund - cash_withdrawal example: purchase amount: type: integer format: int64 minimum: 0 description: >- Transaction amount in the card currency. In the smallest currency unit (e.g. cents). example: 1299 currency: type: string pattern: ^[A-Z]{3}$ description: Three-letter ISO 4217 currency code. example: EUR merchant_amount: type: integer format: int64 minimum: 0 description: >- Amount in the merchant currency. In the smallest currency unit (e.g. cents). example: 1299 merchant_currency: type: string pattern: ^[A-Z]{3}$ description: Three-letter ISO 4217 currency code. example: EUR status: type: string enum: - authorized - declined - reversed - settled decline_reason: type: string nullable: true enum: - insufficient_funds - card_frozen - spending_limit_exceeded - authorization_control - incorrect_pin - suspected_fraud - other description: Set when `status` is `declined`. merchant: type: object properties: name: type: string example: ACME STORE mcc: type: string pattern: ^[0-9]{4}$ example: '5411' city: type: string example: Valencia country: type: string pattern: ^[A-Z]{2}$ description: Two-letter ISO 3166-1 alpha-2 country code. example: ES channel: type: string enum: - online - in_store - contactless - atm created_at: type: string format: date-time description: Time of authorization. readOnly: true settled_at: type: string format: date-time description: Time of settlement. readOnly: true nullable: true Error: type: object required: - error properties: error: type: object required: - type - message - request_id properties: type: type: string enum: - invalid_request - authentication_error - permission_error - not_found - conflict - rate_limit - api_error code: type: string example: card_not_active message: type: string example: The card must be active to perform this action. param: type: string nullable: true example: card_id request_id: type: string example: req_01JZ8R2Q4V responses: BadRequest: description: The request is malformed or missing required parameters. content: application/json: schema: $ref: '#/components/schemas/Error' Unauthorized: description: The API key is missing or invalid. content: application/json: schema: $ref: '#/components/schemas/Error' Forbidden: description: The API key does not have access to this resource. content: application/json: schema: $ref: '#/components/schemas/Error' TooManyRequests: description: Too many requests. Retry after the time given in `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' headers: Retry-After: schema: type: integer description: Seconds to wait before retrying. securitySchemes: bearerAuth: type: http scheme: bearer description: Secret API key, e.g. `sk_live_...` or `sk_test_...`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.