Settlement

GET

View settlement batches and net amounts transferred to a seller balance.

/settlements

Authentication

OAuth 2.0

Permissions

payments:write

Rate limit

120 requests / min

Response

200 OK

Overview

View settlement batches and net amounts transferred to a seller balance.

GET /settlements

GET https://api.mediloop.com/v1/settlements
Authorization: Bearer $ACCESS_TOKEN
X-Tenant-Id: $TENANT_ID

Required scope: payments:write. Access is also constrained by seller organization, tenant membership and Marketplace entitlement.

Field	Type	Required	Description
`idempotency_key`	string	Recommended	Prevents duplicate business actions
`reference_id`	string	Varies	Related Marketplace resource
`metadata`	object	No	Integration metadata

cURL

curl -X GET "https://api.mediloop.com/v1/settlements" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Accept: application/json"

Example response200 OK

{
  "data": {
    "id": "mkt_123",
    "status": "active",
    "updated_at": "2026-08-19T07:00:00Z"
  }
}

Marketplace responses use stable resource IDs and explicit lifecycle states so integrations can reconcile safely.