---
title: "Retorna uma lista de transações."
method: GET
path: "/v1/transactions"
tags: ["transactions"]
---

# Retorna uma lista de transações.

`GET /v1/transactions`

Utilize este método para listar as transações associadas à sua conta na Vindi. Leia a documentação sobre [paginação](http://atendimento.vindi.com.br/hc/pt-br/articles/203020644#pagination) e [filtros de busca](http://atendimento.vindi.com.br/hc/pt-br/articles/204163150).

#### Atributos para busca
<code>id</code>, <code>customer_id</code>, <code>charge_id</code>, <code>gateway_id</code>, <code>connector</code>, <code>payment_method_id</code>, <code>transaction_type</code>, <code>amount</code>, <code>installments</code>, <code>status</code>, <code>import_batch_id</code>, <code>export_batch_id</code>, <code>gateway_authorization</code>, <code>gateway_transaction_id</code>, <code>fraud_detector_score</code>, <code>fraud_detector_status</code>, <code>fraud_detector_id</code>, <code>created_at</code> e <code>updated_at</code>.

## Query parameters

- `page` integer
- `per_page` integer
- `query` string
- `sort_by` 'created_at' | 'updated_at'
- `sort_order` 'asc' | 'desc'

## Response `200`

Consulta realizada com sucesso.

- Transaction[]
  - `id` integer, required — ID da transação
  - `transaction_type` 'charge' | 'refund' | 'authorization' | 'capture' | 'verify' | 'register' | 'void' | 'renew_payment_profile' | 'pre_authorization' | 'update', required — Tipo da transação
  - `status` 'processing' | 'success' | 'rejected' | 'failure' | 'timeout' | 'waiting' | 'canceled' | 'fraud_review', required — Status da transação
  - `amount` number, required — Valor da transação
  - `installments` integer, required — Número de parcelas
  - `gateway_message` string, required — Mensagem de resposta do gateway
  - `gateway_response_code` string, required — Código de resposta do gateway
  - `gateway_authorization` string, required — Código da autorização usado no estorno ou captura. Varia de acordo com o adquirente
  - `gateway_transaction_id` string, required — Código externo de referência do gateway. Para boletos, representa o "nosso número"
  - `gateway_response_fields` string — Atributos de resposta específicos do gateway
  - `fallback_type` string, required — Tipo de Retentativa
  - `fraud_detector_score` number — Pontuação da análise antifraude entre 0.00 e 1.00. Quanto maior a pontuação, maior o risco de fraude
  - `fraud_detector_status` 'automatic_success' | 'manual_success' | 'automatic_rejected' | 'manual_rejected' | 'review' | 'failure' — Status da análise antifraude
  - `fraud_detector_id` string — ID da análise antifraude
  - `created_at` string, required — Data e hora da transação
  - `updated_at` string, required — Data e hora da última atualização da transação
  - `gateway` GatewaySummary, required
    - `id` integer, required — ID do gateway
    - `connector` string, required — Conector utilizado no gateway
  - `payment_profile` PaymentProfileSummary, required
    - `id` integer, required — ID do perfil de pagamento
    - `holder_name` string — Nome do titular/portador do perfil de pagamento
    - `registry_code` string — CPF ou CNPJ do titular/portador
    - `bank_branch` string — Agência da conta bancária
    - `bank_account` string — Número da conta bancária
    - `card_expiration` string — Validade do cartão de crédito no formato MM/AA
    - `allow_as_fallback` string — Permite utilizar o perfil de pagamento em retentativas de cobranças não pagas.
    - `card_number_first_six` string — Primeiros 6 dígitos do cartão de crédito (BIN/IIN)
    - `card_number_last_four` string — Últimos 4 dígitos do cartão de crédito
    - `renewed_card` object
      - `card_number_last_four` string — Últimos quatro dígitos do cartão de crédito renovado
      - `card_expiration` string — Nova validade do cartão de crédito renovado
    - `card_renewed_at` string — Data da renovação do cartão de crédito renovado
    - `token` string, required — Token interno para referência do perfil de pagamento
    - `created_at` string, required — Data e hora do cadastro do perfil de pagamento
    - `payment_company` PaymentCompany, required
      - `id` integer, required — ID da bandeira ou banco
      - `name` string, required — Nome da bandeira ou banco
      - `code` string, required — Código para referência via API
  - `charge` ChargeSummary, required
    - `id` integer, required — ID da cobrança
  - `customer` CustomerSummary, required
    - `id` integer, required — ID do cliente
    - `name` string, required — Nome do cliente
    - `email` string — E-mail do cliente
    - `code` string — Código opcional para referência via API
  - `payment_method` PaymentMethodSummary, required
    - `id` integer, required — ID do método de pagamento
    - `public_name` string, required — Nome público do método de pagamento
    - `name` string, required — Nome interno do método de pagamento
    - `code` string, required — Código externo para referência via API
    - `type` string, required — Tipo do método de pagamento

## Other responses

- `400` — Erro de sintaxe JSON no corpo do request.
- `422` — Parâmetros inválidos. Verificar erro na resposta.

---

[API](https://skmtc.net/vindi/apis/001-vindi-pagamentos-agost.md) · [All operations](https://skmtc.net/vindi/apis/001-vindi-pagamentos-agost/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vindi/001-vindi-pagamentos-agost/revisions/9d11e5de9308/schema)