Listar Conciliações

Use esta rota para listar as conciliações de um parceiro específico, filtradas por intervalo de datas.

Esta rota não depende da habilitação de gestão de saldo.

GETv3/financial/conciliations

Request Query Params

Atributo	Tipo	Descrição
sub_seller_id	string	ID do parceiro cujas conciliações serão listadas.
date_start	date	Início do intervalo no formato YYYY-MM-DD. Padrão: 7 dias antes de date_end (hoje, horário de Brasília).
date_end	date	Fim do intervalo no formato YYYY-MM-DD. Padrão: hoje (horário de Brasília). Deve ser maior ou igual a date_start.
page	int32	Página da consulta. Padrão: 1. Mínimo: 1.
page_size	int32	Quantidade de itens por página. Padrão: 20. Mínimo: 1. Máximo: 100.

Intervalo máximo

O intervalo entre date_start e date_end não pode ultrapassar 180 dias.

Response Object

Atributo	Tipo	Descrição
transfers	array	Lista de transferências do intervalo solicitado.
transfers[][transfer_id]	string	ID da transferência na adquirente.
transfers[][transfer_amount]	int32	Valor da transferência em centavos.
transfers[][transfer_type]	string	Tipo da transferência. Exemplo: ted.
transfers[][transfer_status]	string	Status da transferência.
transfers[][transfer_bank_response]	string	Resposta do banco sobre a transferência.
transfers[][transfer_date_created]	dateTime	Data de criação da transferência no formato ISODateTime.
transfers[][transfer_date_updated]	dateTime	Data de atualização da transferência no formato ISODateTime.
transfers[][transfer_funding_date]	dateTime	Data de liquidação da transferência no formato ISODateTime.
transfers[][transfer_funding_estimated_date]	dateTime	Data estimada de liquidação no formato ISODateTime.

Exemplo de Response

{
  "transfers": [
    {
      "transfer_id": "12345678",
      "transfer_amount": 2200000,
      "transfer_type": "ted",
      "transfer_status": "transferred",
      "transfer_bank_response": "Confirmado",
      "transfer_date_created": "2026-08-20T08:00:00.000Z",
      "transfer_date_updated": "2026-08-20T08:00:00.000Z",
      "transfer_funding_date": "2026-08-20T15:00:00.000Z",
      "transfer_funding_estimated_date": "2026-08-21T00:00:00.000Z"
    }
  ]
}

Error Object

Atributo	Tipo	Descrição
errors	array	Array com todos os erros encontrados ao processar a requisição.
errors[][type]	string	Tipo de erro ocorrido.
errors[][message]	string	Mensagem detalhada do erro ocorrido.

Exemplo de erro

{
  "errors": [
    {
      "type": "not_found",
      "message": "Sub Seller with id [sub_123456789] was not found"
    }
  ]
}

Exemplos

ATENÇÃO

Os valores utilizados nos exemplos abaixo são apenas para ilustração e não devem ser usados para fazer requests nas APIs da Marlim.

Transferências do parceiro

Request

curl -X GET -G "https://api.marlim.co/v3/financial/conciliations" \
-H "Content-Type: application/json" \
-H "api_key: api_key_value" \
-d sub_seller_id="sub_k4m6Rw5rlQszEY7fiuRe" \ 
-d date_start="2026-08-14" \ 
-d date_end="2026-08-20"

Response200

{
  "transfers": [
    {
      "transfer_id": "87654321",
      "transfer_amount": 5000,
      "transfer_type": "ted",
      "transfer_status": "transferred",
      "transfer_bank_response": "Confirmado",
      "transfer_date_created": "2026-08-18T10:00:00.000Z",
      "transfer_date_updated": "2026-08-18T10:00:00.000Z",
      "transfer_funding_date": "2026-08-18T15:00:00.000Z",
      "transfer_funding_estimated_date": "2026-08-19T00:00:00.000Z",
      "transfer_chargedback_owner_type": "marlim"
    }
  ]
}

Intervalo inválido

Request

curl -X GET -G "https://api.marlim.co/v3/financial/conciliations" \
-H "Content-Type: application/json" \
-H "api_key: api_key_value" \
-d date_start="2026-08-20" \ 
-d date_end="2026-08-10"

Response400

{
  "errors": [
    {
      "type": "date_end",
      "message": "The parameter [ date_end ] must be greater than or equal to date_start."
    }
  ]
}

Parceiro não encontrado

Request

curl -X GET -G "https://api.marlim.co/v3/financial/conciliations" \
-H "Content-Type: application/json" \
-H "api_key: api_key_value" \
-d sub_seller_id="sub_123456789"

Response404

{
  "errors": [
    {
      "type": "not_found",
      "message": "Sub Seller with id [sub_123456789] was not found"
    }
  ]
}