> ## 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.

# Listar sessões

> Liste sessões de pagamento criadas na Malga com paginação e filtros usando o método de listagem de sessões da API SDK em Node.js ou PHP.

Liste todas as suas sessões. Você pode filtrar por status, estado de ativação e intervalo de data de criação.

### 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.sessions.list({
      page: 1,
      limit: 15,
      status: ['created', 'paid'],
      isActive: [true],
      startDate: '2026-03-24T03:00:00.000Z',
      endDate: '2026-04-01T02:59:00.000Z',
    })
    ```
  </Tab>
</Tabs>

<Tabs>
  <Tab title="Response">
    ```typescript theme={null}
    {
      items: [
        {
          id: 'bbc9d986-b65e-48fe-b879-2e1df10aea87',
          name: 'Link de Pagamento',
          status: 'created',
          isActive: true,
          clientId: 'd1d2b51a-0446-432a-b055-034518c2660e',
          orderId: null,
          amount: 100,
          currency: 'BRL',
          capture: null,
          merchantId: '8cfef0d1-73af-4bdb-b6c4-09ad3fbfc7f1',
          dueDate: '2023-12-31T03:00:00.000Z',
          description: null,
          statementDescriptor: null,
          items: [
            {
              name: 'Produto 1',
              description: null,
              unitPrice: 100,
              quantity: 1,
              tangible: null
            }
          ],
          paymentLink: '',
          paymentMethods: [
            {
              paymentType: 'pix',
              expiresIn: 500
            },
            {
              paymentType: 'credit',
              installments: 1,
              recurrence: null
            },
            {
              paymentType: 'boleto',
              expiresDate: '2023-12-31T00:00:00.000Z',
              instructions: null
            },
            {
              paymentType: 'drip',
              successRedirectUrl: null,
              cancelRedirectUrl: null
            }
          ],
          createdAt: '2023-01-31T00:00:00.000Z',
          updatedAt: '2023-01-31T00:00:00.000Z',
          publicKey: 'b8d59a73-fd16-4d6b-9e0f-9d7b2a8a7e6d',
        }
      ],
      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="status" type="array">
  Filtra sessões pelo status. O SDK envia os valores unidos por vírgula na query.

  <br />

  <br />

  Os valores suportados são: <code>created</code>, <code>paid</code>, <code>canceled</code>, <code>voided</code>
</ParamField>

<ParamField path="isActive" type="array">
  Filtra sessões ativadas ou desativadas. O SDK envia os valores unidos por vírgula na query.

  <br />

  <br />

  Os valores suportados são: <code>true</code> ou <code>false</code>
</ParamField>

<ParamField path="startDate" type="string">
  Data inicial do período filtrado. O SDK envia este valor como <code>created.gt</code> na API (RFC 3339).

  <br />

  <br />

  Exemplo: <code>2026-03-24T03:00:00.000Z</code>
</ParamField>

<ParamField path="endDate" type="string">
  Data final do período filtrado. O SDK envia este valor como <code>created.lt</code> na API (RFC 3339).

  <br />

  <br />

  Exemplo: <code>2026-04-01T02:59:00.000Z</code>
</ParamField>