Skip to main content
GET
/
v1
/
merchants
/
{merchantId}
/
cashouts
List cashouts for a specific merchant
curl --request GET \
  --url https://api-sandbox.rinne.com.br/core/v1/merchants/{merchantId}/cashouts \
  --header 'x-api-key: <api-key>'
{
  "data": [
    {
      "id": "507f1f77bcf86cd799439011",
      "request_id": "req_123456789",
      "external_request_id": "123e4567-e89b-12d3-a456-426614174000",
      "company_id": "507f1f77bcf86cd799439011",
      "origin_bank_account_id": "507f1f77bcf86cd799439011",
      "destination_bank_account_id": "507f1f77bcf86cd799439012",
      "amount": 10000,
      "fee": 150,
      "cost": 100,
      "fee_policy_id": "507f1f77bcf86cd799439013",
      "cost_policy_id": "507f1f77bcf86cd799439014",
      "method": "PIX",
      "status": "PROCESSING",
      "error_message": "Insufficient funds",
      "created_at": "2025-01-01T10:00:00.000Z",
      "updated_at": "2025-01-01T10:05:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 100,
    "totalPages": 5,
    "hasNext": true,
    "hasPrev": false
  }
}

Authorizations

x-api-key
string
header
required

Company API key for authentication

Path Parameters

merchantId
string
required

The merchant ID

Query Parameters

page
integer
default:1

Page number

Required range: x >= 1
limit
integer
default:20

Number of items per page

Required range: 1 <= x <= 100
status
enum<string>

Filter by cashout status

Available options:
PENDING,
PROCESSING,
COMPLETED,
FAILED
method
enum<string>

Filter by cashout method

Available options:
PIX
created_at_from
string<date-time>

Filter cashouts from this date (inclusive)

created_at_to
string<date-time>

Filter cashouts to this date (inclusive)

request_id
string

Filter by request ID

sort
enum<string>

Sort by field

Available options:
created_at,
amount,
status

Response

Cashouts retrieved successfully

Paginated cashout list response

data
object[]
required

List of cashouts

pagination
object
required

Pagination information