> ## 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 as cobranças

> Liste cobranças de forma paginada com filtros usando o método de listagem da API SDK da Malga em Node.js ou PHP, com parâmetros completos.

Liste todas as suas cobranças.

### 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.charges.list()
    ```
  </Tab>
</Tabs>

<Tabs>
  <Tab title="Response">
    ```typescript theme={null}
    {
      items: [
        {
          id: 'e09ef791-1aaa-4b11-8173-698f2689a04d',
          clientId: 'd1d2b51a-0446-432a-b055-034518c2660e',
          merchantId: '8cfef0d1-73af-4bdb-b6c4-09ad3fbfc7f1',
          description: null,
          orderId: null,
          providerReferenceKey: null,
          createdAt: '2023-12-31T18:19:44.993Z',
          amount: 100,
          originalAmount: 100,
          currency: 'BRL',
          statementDescriptor: null,
          capture: false,
          isDispute: false,
          status: 'pre_authorized',
          paymentMethod: {
            installments: 1,
            paymentType: 'credit',
          },
          paymentSource: {
            sourceType: 'card',
            cardId: '3db399d3-44c1-49fe-ab26-6fb00c161337',
          },
          transactionRequests: [
            {
              id: 'a6cc6bda-3f6d-4277-8ea2-e4bbd9166f16',
              createdAt: '2023-12-31T18:19:45.013Z',
              updatedAt: '2023-12-31T18:19:45.044Z',
              idempotencyKey: '3b42ede3-15a8-4d81-b6e9-54c5762776c6',
              providerId: '694f7eee-2966-4825-a847-65d070cbdece',
              providerType: 'SANDBOX',
              transactionId: '18242a4d-dd35-475f-b79b-5cbe8f9d1fea',
              amount: 100,
              authorizationCode: '123123',
              authorizationNsu: '123123',
              requestStatus: 'success',
              requestType: 'pre_authorization',
              responseTs: '11ms',
              providerAuthorization: {
                networkAuthorizationCode: '123123',
                networkResponseCode: '123123',
              }
            }
          ],
          appInfo: null
        }
      ],
      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>

<ParamField path="sort" type="string">
  Ordenação da listagem, padrão é <code>ASC</code>

  <br />

  <br />

  Os valores suportados são: <code>ASC</code> ou <code>DESC</code>
</ParamField>

<ParamField path="startDate" type="string">
  Data inicial do período filtrado
</ParamField>

<ParamField path="endDate" type="string">
  Data final do período filtrado
</ParamField>

<ParamField path="merchantId" type="uuid">
  ID do Merchant
</ParamField>

<ParamField path="amount" type="number">
  Valor da cobrança
</ParamField>

<ParamField path="orderId" type="string">
  Identificador único da cobrança do lado do cliente para conciliação futura
</ParamField>

<ParamField path="hasSplit" type="boolean">
  Cobranças que foram feitas com Split de pagamentos
</ParamField>

<ParamField path="sessionId" type="uuid">
  Cobrança vinculada à Sessão
</ParamField>

<ParamField path="status" type="array">
  Status atual da cobrança
</ParamField>

<ParamField path="paymentMethod" type="array">
  Método de pagamento da cobrança
</ParamField>

<ParamField path="provider" type="array">
  Provedor utilizado na cobrança
</ParamField>


## Related topics

- [Listar cobranças](/api-reference/charges/listar-cobrancas.md)
- [Listar sessões](/api-reference/sessions/listar-sessoes.md)
- [Realizar nova cobrança](/api-reference/charges/realizar-nova-cobranca.md)
- [Listar cartões](/api-reference/cards/listar-cartoes.md)