---
title: "Listar transferências"
method: GET
path: "/v1/marketplace/transfers"
tags: ["Transferências"]
---

# Listar transferências

`GET /v1/marketplace/transfers`

## Query parameters

- `filters` string
- `search` string
- `perPage` number
- `page` number
- `sorters` string

## Headers

- `integration-key` string, required
- `x-token` string, required

## Response `200`

- object
  - `total` number, required — Número total de registros.
  - `page` number, required — Página atual.
  - `perPage` number, required — Número de registros por página.
  - `lastPage` number, required — Número total de páginas.
  - `data` TransferResponse[]
    - `_id` string, required — ID da transferência.
    - `type` 'TED' | 'P2P' | 'PIX', required — Tipo da transferência.
    - `status` 'CREATED' | 'PENDING' | 'PAID' | 'FAILED' | 'REFUNDED' | 'CANCELED' | 'PROCESSING', required — Status atual da transferência.
    - `amount` number, required — Valor transferido em centavos.
    - `original_amount` number — Valor original da transferência em centavos.
    - `establishment_id` string, required — ID do estabelecimento.
    - `gateway_key` string — Código do gateway.
    - `gateway_authorization` string, required — Código de autorização do gateway.
    - `expected_at` string, date-time, required — Data prevista para conclusão da transferência.
    - `recipient` TransferAccount, required
      - `establishment` TransferEntity, required
        - `id` number, required
        - `first_name` string, required — Nome / Razão Social.
        - `last_name` string, required — Sobrenome / Nome Fantasia.
        - `document` string, required — CPF / CNPJ.
      - `marketplace` TransferEntity, required
        - `id` number, required
        - `first_name` string, required — Nome / Razão Social.
        - `last_name` string, required — Sobrenome / Nome Fantasia.
        - `document` string, required — CPF / CNPJ.
      - `representative` TransferEntity
        - `id` number, required
        - `first_name` string, required — Nome / Razão Social.
        - `last_name` string, required — Sobrenome / Nome Fantasia.
        - `document` string, required — CPF / CNPJ.
      - `document` string, required — Documento do titular (CPF/CNPJ).
      - `bank_code` string — Código do banco.
      - `bank_ispb` string — ISPB do banco.
      - `bank_name` string — Nome do banco.
      - `routing_number` string — Número da agência bancária.
      - `routing_check_digit` string — Dígito verificador da agência.
      - `account_number` string, required — Número da conta bancária.
      - `account_check_digit` string, required — Dígito verificador da conta.
      - `type` 'SAVING' | 'CHECKING' | 'PAYMENT', required — Tipo da conta.
      - `pix_key` string — Chave pix de origem ou destino.
    - `payer` TransferAccount, required
      - `establishment` TransferEntity, required
        - `id` number, required
        - `first_name` string, required — Nome / Razão Social.
        - `last_name` string, required — Sobrenome / Nome Fantasia.
        - `document` string, required — CPF / CNPJ.
      - `marketplace` TransferEntity, required
        - `id` number, required
        - `first_name` string, required — Nome / Razão Social.
        - `last_name` string, required — Sobrenome / Nome Fantasia.
        - `document` string, required — CPF / CNPJ.
      - `representative` TransferEntity
        - `id` number, required
        - `first_name` string, required — Nome / Razão Social.
        - `last_name` string, required — Sobrenome / Nome Fantasia.
        - `document` string, required — CPF / CNPJ.
      - `document` string, required — Documento do titular (CPF/CNPJ).
      - `bank_code` string — Código do banco.
      - `bank_ispb` string — ISPB do banco.
      - `bank_name` string — Nome do banco.
      - `routing_number` string — Número da agência bancária.
      - `routing_check_digit` string — Dígito verificador da agência.
      - `account_number` string, required — Número da conta bancária.
      - `account_check_digit` string, required — Dígito verificador da conta.
      - `type` 'SAVING' | 'CHECKING' | 'PAYMENT', required — Tipo da conta.
      - `pix_key` string — Chave pix de origem ou destino.
    - `history` TransferHistory[], required — Histórico de status da transferência.
      - `status` 'CREATED' | 'PENDING' | 'PAID' | 'FAILED' | 'REFUNDED' | 'CANCELED' | 'PROCESSING', required — Status histórico da transferência.
      - `created_at` string, date-time, required — Data do registro do histórico.
      - `_id` string, required
    - `method` 'IN' | 'OUT', required — Direção da transferência (entrada ou saída).
    - `pixKey` string — Chave Pix utilizada (caso aplicável).
    - `end_to_end` string — Identificador único de cada transação.
    - `description` string — Descrição da transferência.
    - `reprocessed` boolean, required — Indica se a transferência foi reprocessada.
    - `created_at` string, date-time, required — Data de criação da transferência.
    - `updated_at` string, date-time, required — Data da última atualização da transferência.
    - `fees` number — Valor total de taxas da transferência.
    - `user` TransferUser
      - `id` number, required — Id do usuário.
      - `first_name` string, required — Primeiro nome.
      - `last_name` string — Sobrenome.
      - `profile_id` number, required — Id do perfil.

---

[API](https://skmtc.net/paytime/apis/api-p-blica.md) · [All operations](https://skmtc.net/paytime/apis/api-p-blica/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paytime/api-p-blica/revisions/5c818991d183/schema)