List Global Option Sets

List the customer's global option sets.

Use the returned IDs to inspect individual global option sets before editing them.

Behaviour

Filter by name with search; localized fields come back translated — to lang when given, otherwise to your customer's default language.

The full { language: text } maps are a detail-read feature; the list is always translated.

Cursor-paginated.

Requires the globalOptionSets:read scope.

get

Authorizations

AuthorizationstringRequired

API key sent as a bearer token (mk_live_… / mk_test_…).

Query parameters

limitinteger · min: 1 · max: 5000OptionalDefault: 50

cursorstring · min: 1Optional

searchstring · min: 1Optional

Substring match on the option set name.

langstring · min: 2 · max: 10Optional

Language code to translate localized fields to (falls back if unavailable).

Example: en

Responses

200

Successful response.

application/json

400

Invalid request data.

application/json

401

Missing or invalid API key.

application/json

403

The API key lacks the required scope (scope_denied), or the operation is not permitted for this account (operation_not_permitted).

application/json

429

The API key exceeded its request rate (rate_limit_exceeded) or its monthly quota (quota_exceeded). Both carry Retry-After; the RateLimit-* headers accompany rate_limit_exceeded only, since a spent quota says nothing about the bucket.

application/json

500

Internal server error.

application/json

get/v1/global-option-sets

GET /v1/global-option-sets HTTP/1.1
Host: admin.mimeeqapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "optionSetId": "OPT-123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "displayName": "Chair",
      "description": "Chair",
      "status": "ACTIVE",
      "numberOfOptions": 1,
      "createdAt": "text",
      "modifiedAt": "text"
    }
  ],
  "page": {
    "limit": 1,
    "nextCursor": "text"
  }
}