Mediloop
APIsMarketplace APIPayouts

Payouts

GET

Track payouts from settled Marketplace balances to connected accounts.

/payouts

Authentication

OAuth 2.0

Permissions

payments:write

Rate limit

120 requests / min

Response

200 OK

Overview

Track payouts from settled Marketplace balances to connected accounts.

Endpoint

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

Authentication

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

Request body

FieldTypeRequiredDescription
idempotency_keystringRecommendedPrevents duplicate business actions
reference_idstringVariesRelated Marketplace resource
metadataobjectNoIntegration metadata

Example request

cURL
curl -X GET "https://api.mediloop.com/v1/payouts" \
  -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"
  }
}

Example response

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

Responses

HTTPMeaning
200Success
201Created
400Invalid request
401Authentication required
403Insufficient permissions
404Resource not found
409Business-state conflict
429Rate limit exceeded