> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onepay.la/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar tarjetas

> Obtén una lista de todas las tarjetas creadas en tu cuenta.

### Parámetros de consulta

<ParamField query="limit" type="integer">
  Número de registros a retornar por página. Por defecto es 20.
</ParamField>

<ParamField query="filter[type]" type="string">
  Tipo de tarjeta
</ParamField>

<ParamField query="filter[status]" type="string">
  Estado de la tarjeta
</ParamField>

<ParamField query="filter[last_4]" type="string">
  Últimos 4 dígitos de la tarjeta
</ParamField>

<ParamField query="filter[nickname]" type="string">
  Apodo de la tarjeta
</ParamField>

<ParamField query="sort" type="string">
  Orden de los resultados, \[-created\_at | created\_at]
</ParamField>

<ParamField query="page" type="integer">
  Número de página a consultar. Por defecto es 1.
</ParamField>

### Respuesta

<ResponseField name="data" type="Card[]">
  Array de objetos tipo Card
</ResponseField>

<ResponseField name="meta" type="object">
  Metadata de la paginación

  <Expandable title="properties">
    <ResponseField name="current_page" type="integer">
      Página actual
    </ResponseField>

    <ResponseField name="from" type="integer">
      Número del primer registro en la página actual
    </ResponseField>

    <ResponseField name="last_page" type="integer">
      Última página disponible
    </ResponseField>

    <ResponseField name="per_page" type="integer">
      Registros por página
    </ResponseField>

    <ResponseField name="to" type="integer">
      Número del último registro en la página actual
    </ResponseField>

    <ResponseField name="total" type="integer">
      Total de registros disponibles
    </ResponseField>
  </Expandable>
</ResponseField>

### Ejemplo de respuesta

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "9e41fe85-a21b-4145-b127-b9ddd593be5b",
        "status": "created",
        "last_4": null,
        "nickname": null,
        "type": "physical",
        "customer_id": "9e41fe85-a058-4afc-9940-09764468aa5c",
        "wallet_id": "019523d3-419c-7097-a343-b39a8eb7a50c"
      }
    ],
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "per_page": 15,
    "to": 1,
    "total": 1
  }
  ```
</ResponseExample>