> ## Documentation Index > Fetch the complete documentation index at: https://docs.pluggoucash.com/llms.txt > Use this file to discover all available pages before exploring further. # Listar transações > Retorna uma lista paginada de transações da sua conta, com suporte a diversos filtros por status, valor, data e identificadores. ## OpenAPI ````yaml GET /transactions openapi: 3.1.0 info: title: Pluggou API description: API de intermediação de pagamentos da Pluggou version: 1.0.0 servers: - url: https://api.pluggoutech.com/api security: - publicKey: [] secretKey: [] paths: /transactions: get: tags: - Transações summary: Listar transações description: >- Retorna uma lista paginada de transações da sua conta, com suporte a diversos filtros por status, valor, data e identificadores. operationId: listTransactions parameters: - name: id in: query description: Busca exata pelo UUID da transação. schema: type: string format: uuid - name: e2e_id in: query description: Busca exata pelo identificador end-to-end do PIX. schema: type: string - name: amount_min in: query description: Valor mínimo da transação em centavos. schema: type: integer example: 5000 - name: amount_max in: query description: Valor máximo da transação em centavos. schema: type: integer - name: status in: query description: Filtra por status da transação. schema: type: string enum: - pending - paid - failed - canceled - refunded - chargeback example: paid - name: paid_at_min in: query description: Data/hora mínima de pagamento no formato `Y-m-d H:i:s` (UTC-3). schema: type: string - name: paid_at_max in: query description: Data/hora máxima de pagamento no formato `Y-m-d H:i:s` (UTC-3). schema: type: string - name: created_at_min in: query description: Data/hora mínima de criação no formato `Y-m-d H:i:s` (UTC-3). schema: type: string example: '2026-01-01 00:00:00' - name: created_at_max in: query description: Data/hora máxima de criação no formato `Y-m-d H:i:s` (UTC-3). schema: type: string example: '2026-01-31 23:59:59' - name: page in: query description: 'Página da listagem (padrão: 1).' schema: type: integer default: 1 example: 1 responses: '200': description: Transações listadas com sucesso content: application/json: schema: $ref: '#/components/schemas/ListTransactionsSuccess' example: success: true message: Transações listadas com sucesso. data: transactions: - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 payment_method: pix e2e_id: E12345678202301011234abcdefghijkl amount: 10000 platform_tax: 149 liquid_amount: 9851 status: paid paid_at: '2026-01-29 11:30:00' created_at: '2026-01-29 11:25:00' - id: b2c3d4e5-f6a1-7890-bcde-234567890abc payment_method: pix e2e_id: null amount: 5000 platform_tax: 99 liquid_amount: 4901 status: pending paid_at: null created_at: '2026-01-29 10:15:00' pagination: current_page: 1 last_page: 5 per_page: 10 total: 47 '401': description: Erro de autenticação content: application/json: schema: $ref: '#/components/schemas/AuthErrorResponse' examples: credenciais_ausentes: summary: Credenciais ausentes value: error: Credenciais inválidas message: Chave pública e chave privada são obrigatórias credenciais_invalidas: summary: Credenciais inválidas value: error: Credenciais inválidas message: Chave não encontrada ou inativa '403': description: Erro de permissão content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: conta_nao_aprovada: summary: Conta não aprovada value: success: false message: >- Sua conta precisa estar aprovada para usar esta funcionalidade. data: null conta_bloqueada: summary: Conta bloqueada value: success: false message: Sua conta está bloqueada. data: null '422': description: Erro de validação nos filtros content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponse' example: success: false message: Erro de validação nos filtros fornecidos data: errors: status: - >- Status inválido. Valores aceitos: pending, paid, failed, canceled, refunded, chargeback. components: schemas: ListTransactionsSuccess: type: object properties: success: type: boolean description: Indica se a operação foi bem-sucedida. message: type: string description: Mensagem descritiva do resultado. data: type: object properties: transactions: type: array description: Lista de transações retornadas. items: type: object properties: id: type: string format: uuid description: Identificador único da transação (UUID). payment_method: type: string description: Método de pagamento utilizado. e2e_id: type: string nullable: true description: >- Identificador end-to-end do PIX. `null` se ainda não confirmado. amount: type: integer description: Valor total da transação em centavos. platform_tax: type: integer description: Taxa da plataforma em centavos. liquid_amount: type: integer description: Valor líquido em centavos. status: type: string enum: - pending - paid - failed - canceled - refunded - chargeback description: Status atual da transação. paid_at: type: string nullable: true description: Data/hora do pagamento. `null` se não pago. created_at: type: string description: Data/hora de criação da transação. pagination: type: object description: Dados de paginação. properties: current_page: type: integer description: Página atual. last_page: type: integer description: Última página disponível. per_page: type: integer description: Quantidade de registros por página. total: type: integer description: Total de registros encontrados. AuthErrorResponse: type: object properties: error: type: string description: Tipo do erro de autenticação. message: type: string description: Mensagem descritiva do erro. ErrorResponse: type: object properties: success: type: boolean description: Sempre `false` em caso de erro. message: type: string description: Mensagem descritiva do erro. data: type: object nullable: true description: Sempre `null` em erros simples. ValidationErrorResponse: type: object properties: success: type: boolean description: Sempre `false` em caso de erro. message: type: string description: Mensagem descritiva do erro. data: type: object properties: errors: type: object description: >- Objeto onde cada chave é o nome do campo e o valor é um array com as mensagens de erro. additionalProperties: type: array items: type: string securitySchemes: publicKey: type: apiKey in: header name: X-Public-Key description: 'Sua chave pública de acesso à API. Ex: `pk_live_abc123def456...`' secretKey: type: apiKey in: header name: X-Secret-Key description: 'Sua chave secreta de acesso à API. Ex: `sk_live_xyz789ghi012...`' ````