Cards

GET

/executions/results/:execution_id/financial/v1/cards

GET

/api/executions/results/:execution_id/financial/v1/cards

curl https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/cards \
     -H "X-APP-SECRET: <apiKey>"

[
  {
    "available": {
      "amount": "990.00",
      "currency": "EUR"
    },
    "customer_segment": "personal",
    "disposed": {
      "amount": "-10.00",
      "currency": "EUR"
    },
    "entity_code": "9999",
    "entity_country": "ES",
    "expiration_date": "2028-12-31",
    "fetch_date": "2026-09-12T01:48:52+00:00",
    "holder_name": "MOISÉS ÁGUILA BARRANCO",
    "id": "6aa75283bfa8241c43cb62ea",
    "identifier": {
      "brand": "Visa",
      "masked": "467578******2271",
      "type": "pan"
    },
    "limit": {
      "amount": "1000.00",
      "currency": "EUR"
    },
    "linked_account": {
      "control_digits": "18",
      "entity_code": "9999",
      "entity_country": "ES",
      "entity_office": "0000",
      "masked": "ES379999************8314",
      "type": "iban",
      "value": "ES3799990000186703078314"
    },
    "payment_amount": {
      "amount": "NaN",
      "currency": "EUR"
    },
    "product": "financial_card",
    "product_alias": "Mi Tarjeta de Crédito 0",
    "product_description": "Tarjeta de Crédito de Ejemplo 0",
    "product_name": "Tarjeta de Crédito 0",
    "status": "blocked",
    "sub_family": "financial_card:credit",
    "transactions": [
      {
        "amount": {
          "amount": "-100.00",
          "currency": "EUR"
        },
        "descriptions": [
          "Transaction 5"
        ],
        "status": "booked",
        "type": "default",
        "value_date": "2026-09-12"
      },
      {
        "amount": {
          "amount": "-100.00",
          "currency": "EUR"
        },
        "descriptions": [
          "Transaction 4"
        ],
        "status": "booked",
        "type": "default",
        "value_date": "2026-09-12"
      },
      {
        "amount": {
          "amount": "-100.00",
          "currency": "EUR"
        },
        "descriptions": [
          "Transaction 3"
        ],
        "status": "booked",
        "type": "default",
        "value_date": "2026-09-12"
      },
      {
        "amount": {
          "amount": "-100.00",
          "currency": "EUR"
        },
        "descriptions": [
          "Transaction 2"
        ],
        "status": "booked",
        "type": "default",
        "value_date": "2026-08-15"
      },
      {
        "amount": {
          "amount": "-100.00",
          "currency": "EUR"
        },
        "descriptions": [
          "Transaction 1"
        ],
        "status": "booked",
        "type": "default",
        "value_date": "2026-08-15"
      }
    ]
  },
  {
    "available": {
      "amount": "4000.00",
      "currency": "EUR"
    },
    "customer_segment": "personal",
    "disposed": {
      "amount": "0.00",
      "currency": "EUR"
    },
    "entity_code": "9999",
    "entity_country": "ES",
    "expiration_date": "2028-12-31",
    "fetch_date": "2026-09-12T01:48:52+00:00",
    "holder_name": "MOISÉS ÁGUILA BARRANCO",
    "id": "6aa75283bfa8241c43cb62ec",
    "identifier": {
      "brand": "Visa",
      "masked": "448487******1259",
      "type": "pan"
    },
    "limit": {
      "amount": "4000.00",
      "currency": "EUR"
    },
    "linked_account": {
      "control_digits": "18",
      "entity_code": "9999",
      "entity_country": "ES",
      "entity_office": "0000",
      "masked": "ES429999************8040",
      "type": "iban",
      "value": "ES4299990000180496468040"
    },
    "payment_amount": {
      "amount": "NaN",
      "currency": "EUR"
    },
    "product": "financial_card",
    "product_alias": "Mi Tarjeta de Crédito 1",
    "product_description": "Tarjeta de Crédito de Ejemplo 1",
    "product_name": "Tarjeta de Crédito 1",
    "status": "active",
    "sub_family": "financial_card:credit",
    "transactions": [
      {
        "amount": {
          "amount": "-100.00",
          "currency": "EUR"
        },
        "descriptions": [
          "Transaction 5"
        ],
        "status": "booked",
        "type": "default",
        "value_date": "2026-09-12"
      },
      {
        "amount": {
          "amount": "-100.00",
          "currency": "EUR"
        },
        "descriptions": [
          "Transaction 4"
        ],
        "status": "booked",
        "type": "default",
        "value_date": "2026-09-12"
      },
      {
        "amount": {
          "amount": "-100.00",
          "currency": "EUR"
        },
        "descriptions": [
          "Transaction 3"
        ],
        "status": "booked",
        "type": "default",
        "value_date": "2026-09-12"
      },
      {
        "amount": {
          "amount": "-100.00",
          "currency": "EUR"
        },
        "descriptions": [
          "Transaction 2"
        ],
        "status": "booked",
        "type": "default",
        "value_date": "2026-08-15"
      },
      {
        "amount": {
          "amount": "-100.00",
          "currency": "EUR"
        },
        "descriptions": [
          "Transaction 1"
        ],
        "status": "booked",
        "type": "default",
        "value_date": "2026-08-15"
      }
    ]
  },
  {
    "available": {
      "amount": "-10.00",
      "currency": "USD"
    },
    "customer_segment": "personal",
    "disposed": {
      "amount": "-2510.00",
      "currency": "USD"
    },
    "entity_code": "9999",
    "entity_country": "ES",
    "expiration_date": "2028-12-31",
    "fetch_date": "2026-09-12T01:48:52+00:00",
    "holder_name": "MOISÉS ÁGUILA BARRANCO",
    "id": "6aa75283bfa8241c43cb62ee",
    "identifier": {
      "brand": "Mastercard",
      "masked": "226748******2200",
      "type": "pan"
    },
    "limit": {
      "amount": "2500.00",
      "currency": "USD"
    },
    "linked_account": {
      "control_digits": "13",
      "entity_code": "9999",
      "entity_country": "ES",
      "entity_office": "0000",
      "masked": "ES479999************8219",
      "type": "iban",
      "value": "ES4799990000132533118219"
    },
    "payment_amount": {
      "amount": "NaN",
      "currency": "USD"
    },
    "product": "financial_card",
    "product_alias": "Mi Tarjeta de Crédito 2",
    "product_description": "Tarjeta de Crédito de Ejemplo 2",
    "product_name": "Tarjeta de Crédito 2",
    "status": "blocked",
    "sub_family": "financial_card:credit",
    "transactions": [
      {
        "amount": {
          "amount": "-100.00",
          "currency": "USD"
        },
        "descriptions": [
          "Transaction 5"
        ],
        "status": "booked",
        "type": "default",
        "value_date": "2026-09-12"
      },
      {
        "amount": {
          "amount": "-100.00",
          "currency": "USD"
        },
        "descriptions": [
          "Transaction 4"
        ],
        "status": "booked",
        "type": "default",
        "value_date": "2026-09-12"
      },
      {
        "amount": {
          "amount": "-100.00",
          "currency": "USD"
        },
        "descriptions": [
          "Transaction 3"
        ],
        "status": "booked",
        "type": "default",
        "value_date": "2026-09-12"
      },
      {
        "amount": {
          "amount": "-100.00",
          "currency": "USD"
        },
        "descriptions": [
          "Transaction 2"
        ],
        "status": "booked",
        "type": "default",
        "value_date": "2026-08-15"
      },
      {
        "amount": {
          "amount": "-100.00",
          "currency": "USD"
        },
        "descriptions": [
          "Transaction 1"
        ],
        "status": "booked",
        "type": "default",
        "value_date": "2026-08-15"
      }
    ]
  },
  {
    "customer_segment": "personal",
    "entity_code": "9999",
    "entity_country": "ES",
    "expiration_date": "2028-10-31",
    "fetch_date": "2026-09-12T01:48:52+00:00",
    "holder_name": "MOISÉS ÁGUILA BARRANCO",
    "id": "6aa75283bfa8241c43cb62eb",
    "identifier": {
      "brand": "Visa",
      "masked": "497266******3647",
      "type": "pan"
    },
    "linked_account": {
      "control_digits": "18",
      "entity_code": "9999",
      "entity_country": "ES",
      "entity_office": "0000",
      "masked": "ES379999************8314",
      "type": "iban",
      "value": "ES3799990000186703078314"
    },
    "product": "financial_card",
    "product_alias": "Mi Tarjeta de Débito 0",
    "product_description": "Tarjeta de Débito de Ejemplo 0",
    "product_name": "Tarjeta de Débito 0",
    "status": "blocked",
    "sub_family": "financial_card:debit"
  },
  {
    "customer_segment": "personal",
    "entity_code": "9999",
    "entity_country": "ES",
    "expiration_date": "2028-10-31",
    "fetch_date": "2026-09-12T01:48:52+00:00",
    "holder_name": "MOISÉS ÁGUILA BARRANCO",
    "id": "6aa75283bfa8241c43cb62ed",
    "identifier": {
      "brand": "Visa",
      "masked": "415174******5916",
      "type": "pan"
    },
    "linked_account": {
      "control_digits": "18",
      "entity_code": "9999",
      "entity_country": "ES",
      "entity_office": "0000",
      "masked": "ES429999************8040",
      "type": "iban",
      "value": "ES4299990000180496468040"
    },
    "product": "financial_card",
    "product_alias": "Mi Tarjeta de Débito 1",
    "product_description": "Tarjeta de Débito de Ejemplo 1",
    "product_name": "Tarjeta de Débito 1",
    "status": "active",
    "sub_family": "financial_card:debit"
  },
  {
    "customer_segment": "personal",
    "entity_code": "9999",
    "entity_country": "ES",
    "expiration_date": "2028-10-31",
    "fetch_date": "2026-09-12T01:48:52+00:00",
    "holder_name": "MOISÉS ÁGUILA BARRANCO",
    "id": "6aa75283bfa8241c43cb62ef",
    "identifier": {
      "brand": "Mastercard",
      "masked": "510586******2537",
      "type": "pan"
    },
    "linked_account": {
      "control_digits": "13",
      "entity_code": "9999",
      "entity_country": "ES",
      "entity_office": "0000",
      "masked": "ES479999************8219",
      "type": "iban",
      "value": "ES4799990000132533118219"
    },
    "product": "financial_card",
    "product_alias": "Mi Tarjeta de Débito 2",
    "product_description": "Tarjeta de Débito de Ejemplo 2",
    "product_name": "Tarjeta de Débito 2",
    "status": "blocked",
    "sub_family": "financial_card:debit"
  }
]

Debit, credit and prepaid cards, with their movements.

Each card carries its type, its masked number, the account it settles against, the limits and balances the institution publishes, and the transactions retrieved. Field by field in Cards.

A debit card usually has no movements of its own. It spends the balance of the account it is bound to, so its purchases are that account’s transactions; a credit card is the one with a statement of its own. Read both together, and expect transactions to be empty on the debit side.

Card numbers are never reconstructed. What comes back is what the institution itself shows — a masked number — handled as protected data end to end.

Requires the cards_read feature

Features are chosen when the execution starts, not here. An execution that did not ask for cards_read answers 204, and the only way to get the data is to run another one.

Movements are opt-in: read_transactions defaults to false, so a run that did not ask for it returns the cards without them. from_date / to_date decide the period, and filter_by_type narrows which kinds are read.

Status	Meaning
`200`	The cards. `product` and `sub_family` say which kind each one is.
`202`	`feature_not_ready` — `cards_read` is still running. Only this family waits: the ones that already closed answer now.
`204`	The execution never asked for `cards_read`. No body.
`404`	No execution with that id for your application, or it has been deleted.

Server to server only. This call is authorised with your application secret: it belongs in your backend, never in a browser, a mobile app or anything your customer can read.

Debit, credit and prepaid cards, with their movements. Each card carries its type, its masked number, the account it settles against, the limits and balances the institution publishes, and the transactions retrieved. Field by field in [Cards](/guides/data-models/banking/cards). <Note> **A debit card usually has no movements of its own.** It spends the balance of the account it is bound to, so its purchases are that account's transactions; a credit card is the one with a statement of its own. Read both together, and expect `transactions` to be empty on the debit side. </Note> <Note> **Card numbers are never reconstructed.** What comes back is what the institution itself shows — a masked number — handled as protected data end to end. </Note> <Note title="Requires the `cards_read` feature"> Features are chosen when the execution **starts**, not here. An execution that did not ask for `cards_read` answers `204`, and the only way to get the data is to run another one. **Movements are opt-in**: `read_transactions` defaults to `false`, so a run that did not ask for it returns the cards without them. `from_date` / `to_date` decide the period, and `filter_by_type` narrows which kinds are read. </Note> | Status | Meaning | | :--- | :--- | | `200` | The cards. `product` and `sub_family` say which kind each one is. | | `202` | `feature_not_ready` — `cards_read` is still running. **Only this family waits**: the ones that already closed answer now. | | `204` | The execution never asked for `cards_read`. No body. | | `404` | No execution with that id for your application, or it has been deleted. | <Note> **Server to server only.** This call is authorised with your application secret: it belongs in your backend, never in a browser, a mobile app or anything your customer can read. </Note>

Authentication

X-APP-SECRETstring

Application Secret

Path parameters

execution_idstringRequiredformat: "object-id"

The execution, as the acceptance response returned it.

Response

200 OK
Credit, debit and prepaid cards in one list. product and sub_family say which kind each one is, and the fields that only exist for one of them are absent from the others rather than empty.

An empty list is an answer, not a gap: the feature ran and the source reported none.

**200 OK**<br>Credit, debit and prepaid cards in one list. `product` and `sub_family` say which kind each one is, and the fields that only exist for one of them are absent from the others rather than empty. **An empty list is an answer, not a gap**: the feature ran and the source reported none.

Credit Cardobject

Debit Cardobject

Prepaid Cardobject

Errors

404

Not Found Error

422

Unprocessable Entity Error