Categories

GET

Browse product categories used to organize the Marketplace catalog.

/categories

Authentication

OAuth 2.0

Permissions

marketplace:read

Rate limit

120 requests / min

Response

200 OK

Overview

Browse product categories used to organize the Marketplace catalog.

GET /categories

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

Required scope: marketplace:read. 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/categories" \
  -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.