GET/transactionsDeprecated

Listar por Página (obsoleto)

**Depreciado**: este endpoint está depreciado e estará disponível apenas até **2026-12-31**, após o qual será removido. Por favor, migre para `GET /v2/transactions`, que utiliza paginação baseada em cursor. Recupera todas as transações coletadas para a conta fornecida.

❗️

DESATIVAÇÃO

Em favor do /v2/transactions que pagina transações usando cursor, este endpoint foi estabelecido como descontinuado e deve começar a usar o novo o mais rápido possível.

As transações devem ser copiadas para seus sistemas. Este endpoint deve ser usado uma vez por sincronização e não conectado a nenhuma aplicação diretamente.

Como recomendações gerais, esperamos que você use este endpoint conectado a webhooks de criação, atualização e exclusão com filtros específicos que foram projetados para desempenho, e paginando a maior quantidade de registros por página (500), que é o padrão atual.

📘

Disponibilidade dos campos

O campo ProviderId é retornado apenas em conexões Regulado, consistente com o ID do banco. Seria o mesmo para a mesma conta conectada como itens diferentes.

O campo ProviderCode é retornado apenas em Regulado e certos conectores.

Parameters

Query Parameters

Name	Type	Description
`accountId`required	string (uuid)	Identificador primário da conta
`ids`	array	Array de identificadores de transação. Se definido, os parâmetros 'from' e 'to' serão descartados. Máximo de 500 ids por solicitação.
`from`	string (date-time)	Filtrar maior que a data. Formato (aaaa-mm-dd)
`to`	string (date-time)	Filtrar abaixo da data. Formato (aaaa-mm-dd)
`pageSize`	number (double)	Tamanho da página para a solicitação de paginação, padrão: 500
`page`	number (double)	Número da página para a solicitação de paginação, padrão: 1
`billId`	string (uuid)	Identificador principal da fatura do cartão de crédito, se a conta for um cartão de crédito.
`createdAtFrom`	string (date-time)	Filtrar maior que createdAt. Formato (aaaa-mm-ddThh:mm:ss.000Z)

Responses

200Recupere uma lista de todas as transações de uma conta

object

resultsrequiredobject[]

itemsobject

Transaction product

pagerequirednumber (double)

totalrequirednumber (double)

totalPagesrequirednumber (double)

Example response

json

{
  "results": [
    {
      "id": "6ec156fe-e8ac-4d9a-a4b3-7770529ab01c",
      "description": "TED Example",
      "descriptionRaw": null,
      "currencyCode": "BRL",
      "amount": 1500,
      "date": "2020-10-14T00:00:00.000Z",
      "balance": 3500,
      "category": "Transfers",
      "categoryId": "05000000",
      "accountId": "03cc0eff-4ec5-495c-adb3-1ef9611624fc",
      "providerCode": "123456",
      "type": "CREDIT",
      "status": "POSTED",
      "paymentData": {
        "payer": {
          "name": "Tiago Rodrigues Santos",
          "branchNumber": "090",
          "accountNumber": "1234-5",
          "routingNumber": "001",
          "documentNumber": {
            "type": "CPF",
            "value": "882.937.076-23"
          }
        },
        "reason": "Taxa de serviço",
        "receiver": {
          "name": "Pluggy",
          "branchNumber": "999",
          "accountNumber": "9876-1",
          "routingNumber": "002",
          "documentNumber": {
            "type": "CNPJ",
            "value": "08.050.608/0001-32"
          }
        },
        "paymentMethod": "TED",
        "referenceNumber": "123456789"
      },
      "merchant": null,
      "providerId": null
    }
  ],
  "page": 0,
  "total": 0,
  "totalPages": 0
}

curl -X GET \
  'https://api.pluggy.ai/transactions' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY'

Resposta de exemplo

{
  "results": [
    {
      "id": "6ec156fe-e8ac-4d9a-a4b3-7770529ab01c",
      "description": "TED Example",
      "descriptionRaw": null,
      "currencyCode": "BRL",
      "amount": 1500,
      "date": "2020-10-14T00:00:00.000Z",
      "balance": 3500,
      "category": "Transfers",
      "categoryId": "05000000",
      "accountId": "03cc0eff-4ec5-495c-adb3-1ef9611624fc",
      "providerCode": "123456",
      "type": "CREDIT",
      "status": "POSTED",
      "paymentData": {
        "payer": {
          "name": "Tiago Rodrigues Santos",
          "branchNumber": "090",
          "accountNumber": "1234-5",
          "routingNumber": "001",
          "documentNumber": {
            "type": "CPF",
            "value": "882.937.076-23"
          }
        },
        "reason": "Taxa de serviço",
        "receiver": {
          "name": "Pluggy",
          "branchNumber": "999",
          "accountNumber": "9876-1",
          "routingNumber": "002",
          "documentNumber": {
            "type": "CNPJ",
            "value": "08.050.608/0001-32"
          }
        },
        "paymentMethod": "TED",
        "referenceNumber": "123456789"
      },
      "merchant": null,
      "providerId": null
    }
  ],
  "page": 0,
  "total": 0,
  "totalPages": 0
}