List Conciliations

Use this route to list conciliations for a specific partner, filtered by a date range.

This route does not require balance-management enablement.

GETv3/financial/conciliations

Request Query Params

Attribute	Type	Description
sub_seller_id	string	Partner ID whose conciliations will be listed.
date_start	date	Start of the range in YYYY-MM-DD. Default: 7 days before date_end (today, Brasília time).
date_end	date	End of the range in YYYY-MM-DD. Default: today (Brasília time). Must be greater than or equal to date_start.
page	int32	Page number. Default: 1. Minimum: 1.
page_size	int32	Items per page. Default: 20. Minimum: 1. Maximum: 100.

Maximum range

The interval between date_start and date_end cannot exceed 180 days.

Response Object

Attribute	Type	Description
transfers	array	Transfers in the requested range.
transfers[][transfer_id]	string	Acquirer transfer ID.
transfers[][transfer_amount]	int32	Transfer amount in cents.
transfers[][transfer_type]	string	Transfer type. Example: ted.
transfers[][transfer_status]	string	Transfer status.
transfers[][transfer_bank_response]	string	Bank response for the transfer.
transfers[][transfer_date_created]	dateTime	Transfer creation date in ISODateTime format.
transfers[][transfer_date_updated]	dateTime	Transfer update date in ISODateTime format.
transfers[][transfer_funding_date]	dateTime	Transfer settlement date in ISODateTime format.
transfers[][transfer_funding_estimated_date]	dateTime	Estimated settlement date in ISODateTime format.

Example 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

Attribute	Type	Description
errors	array	Array with all errors found while processing the request.
errors[][type]	string	Type of error that occurred.
errors[][message]	string	Detailed message of the error that occurred.

Example error

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

Examples

ATTENTION

The values used in the examples below are for illustration only and must not be used to make requests to Marlim APIs.

Partner transfers

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"
    }
  ]
}

Invalid range

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."
    }
  ]
}

Partner not found

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"
    }
  ]
}