---
title: "Reads all Card payments"
method: GET
path: "/api/2026-10-01/resources/banking/card_payments"
tags: ["Banking > CardPayment"]
---

# Reads all Card payments

`GET /api/2026-10-01/resources/banking/card_payments`

## Request

- Base URL: `https://api.factorialhr.com`
- URL: `https://api.factorialhr.com/api/2026-10-01/resources/banking/card_payments`
- Auth: API key in header `x-api-key`

Reads all Card payments

## Query parameters

- `ids[]` string[]: An array of card payment IDs to filter by.
- `account_ids[]` string[]: An array of banking accounts ID to filter
- `status` 'pending' | 'closed' | 'reversed' | 'rejected': The status of the card payment.
- `from` string: Date from which the card payment was created in factorial.
- `to` string: Date until which the card payment was created in factorial.

## Response `200`

OK

- object
  - `data` BankingCardPayment[]
    - `id` string, required: The ID of the card payment.
    - `card_id` string, required: The ID of the card.
    - `amount_cents` integer, required: The amount of the card payment.
    - `currency` string, required: The currency of the card payment.
    - `merchant_name` string, required: The name of the merchant.
    - `merchant_amount_cents` integer, required: The amount of the merchant.
    - `merchant_currency` string, required: The currency of the merchant.
    - `approved` boolean, required: Whether the card payment was approved.
    - `external_created_at` string, required: The date and time the card payment was created in the external system.
    - `status` 'pending' | 'closed' | 'reversed' | 'rejected', required: The status of the card payment.
    - `type` 'payment' | 'refund', required: The type of the card payment.
    - `exchange_rate` number, required: The exchange rate of the card payment.
    - `rejected_reason` 'account_disabled' | 'card_active' | 'card_canceled' | 'card_expired' | 'card_inactive' | 'cardholder_blocked' | 'cardholder_inactive' | 'cardholder_verification_required' | 'insecure_authorization_method' | 'insufficient_funds' | 'not_allowed' | 'pin_blocked' | 'spending_controls' | 'suspected_fraud' | 'verification_failed' | 'webhook_approved' | 'webhook_declined' | 'webhook_error' | 'webhook_timeout' | 'authentication_failed' | 'incorrect_cvc' | 'incorrect_expiry' | 'account_compliance_disabled' | 'account_inactive' | 'authorization_controls': The reason the card payment was rejected.
    - `created_at` string, required: The date and time the card payment was created in factorial
  - `meta` PagedIndexMeta
    - `start_cursor` string
    - `end_cursor` string
    - `has_previous_page` boolean, required
    - `has_next_page` boolean, required
    - `limit` integer, required
    - `total` integer, required

## Changes

- **2026-11-03** `83ac9aa1de50`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/factorialhr/apis/factorial-api/changes/api/2026-10-01/resources/banking/card_payments/get.md)

---

[API](https://skmtc.dev/factorialhr/apis/factorial-api.md) - [All operations](https://skmtc.dev/factorialhr/apis/factorial-api/llms.txt) - [OpenAPI document](https://skmtc.dev/factorialhr/apis/factorial-api/revisions/83ac9aa1de50?raw)