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

> ## Agent Instructions
> Responda em português brasileiro, na segunda pessoa ("você"), com base na documentação Malga.
> Não invente endpoints, parâmetros, status codes ou comportamentos de API. Se não estiver na docs, diga que não encontrou e indique a página mais próxima.
> Use os headers X-Client-Id e X-Api-Key nos exemplos de autenticação.
> Motor de Assinaturas refere-se a /v1/subscriptions* (cycles, trial, retentativas, webhooks subscription.*). Não chame de "motor de recorrência".
> Recorrência (provedor) é paymentMethod.recurrence em POST /v1/charges (initial / subsequent / unscheduled), distinto do Motor de Assinaturas.
> Sandbox é ambiente de testes e não afeta produção.

# Listar os cartões

> Liste de forma paginada os cartões armazenados na sua conta Malga usando o método de listagem de cartões da API SDK em Node.js ou PHP.

Liste todos os seus cartões armazenados.

### Método

<Tabs>
  <Tab title="Node.js">
    ```typescript theme={null}
    import { Malga } from 'malga'

    const malga = new Malga({
      apiKey: '17a64c8f-a387-4682-bdd8-d280493715e0',
      clientId: 'd1d2b51a-0446-432a-b055-034518c2660e',
    })

    await malga.cards.list()
    ```
  </Tab>
</Tabs>

<Tabs>
  <Tab title="response">
    ```typescript theme={null}
    {
      items: [
        {
          id: '290d6f2e-7860-4722-b461-fcc9c27a7ca6',
          status: 'active',
          createdAt: '2023-12-31T03:00:00.000Z',
          clientId: '9c80a722-30dd-4bc1-9270-20d505671d1a',
          customerId: null,
          brand: 'Mastercard',
          cardHolderName: 'João da Silva',
          cvvChecked: true,
          fingerprint: '/cddsad2sgTXxfNhdsadasdas2QSLsJ/dsadsadcxc=',
          first6digits: '545388',
          last4digits: '7600',
          expirationMonth: '10',
          expirationYear: '2030',
        }
      ],
      meta: {
        totalItems: 1
        itemCount: 1
        itemsPerPage: 15
        totalPages: 1
        currentPage: 1
      }
    }
    ```
  </Tab>
</Tabs>

### Parâmetros

Lista de todos os parâmetros suportados pelo método.

<ParamField path="page" type="number">
  Número da página que deverá ser listada
</ParamField>

<ParamField path="limit" type="number">
  Limite de itens por página
</ParamField>


## Related topics

- [Listar cartões vinculados](/sdks/api-sdks/docs/customers/list-cards-customer.md)
- [Listar cartões](/api-reference/cards/listar-cartoes.md)
- [Sobre as APIs da Malga](/api-reference/about-apis.md)
- [Listar documentos](/api-reference/sellers/listar-documentos.md)