Box Observer Docs
Open app
API / Reference

Operators

Cinema operators and their classifications.

Production · organization access required

Requests require an active organization grant and an API key or Clerk session. Results respect your granted scopes and markets. Access details →

GET/v1/operators

Operators.

Parameters

NameTypeDetails
limitquery · optionalintegerDefault: 50 · Minimum: 1 · Maximum: 100
cursorquery · optionalstringOpaque cursor from the previous response. Preserve the same filters.
countryCodequery · optionalstringOptional two-letter country filter. This narrows results; it does not grant access.Pattern: ^[A-Za-z]{2}$
Shell · authenticated request
curl "https://api.boxobserver.com/v1/operators" \
  -H "Authorization: Bearer $BOX_OBSERVER_API_KEY"

Response

200 application/json · Success shape within your granted access.

Illustrative response shape · not live data
{
  "data": [],
  "page": {
    "nextCursor": null,
    "hasMore": false
  },
  "meta": {
    "requestId": "example-request-id",
    "generatedAt": "2026-09-04T12:00:00.000Z"
  }
}
Response fields
FieldType and constraints
dataRequiredarray<object>
data[].idRequiredstringPattern: ^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$
data[].nameRequiredstring
data[].typeRequiredstring | nullValues: commercial_chain, independent, municipal, cultural,
pageRequiredobject
page.nextCursorRequiredstring | null
page.hasMoreRequiredboolean
metaRequiredobject
meta.requestIdRequiredstring
meta.generatedAtRequiredstringFormat: date-time

Errors: 400, 401, 403, 429, 500, 503. Response format and retry guidance →

GET/v1/operators/{id}

Operator.

Replace {id} with the appropriate public identifier returned by the API.

Parameters

NameTypeDetails
idpath · requiredstringPublic resource identifier returned by the API.
Shell · authenticated request
curl "https://api.boxobserver.com/v1/operators/{id}" \
  -H "Authorization: Bearer $BOX_OBSERVER_API_KEY"

Response

200 application/json · Success shape within your granted access.

Illustrative response shape · not live data
{
  "data": {
    "id": "opr_ZXhhbXBsZQ",
    "name": "example",
    "type": null
  },
  "meta": {
    "requestId": "example-request-id",
    "generatedAt": "2026-09-04T12:00:00.000Z"
  }
}
Response fields
FieldType and constraints
dataRequiredobject
data.idRequiredstringPattern: ^(mkt|opr|ven|aud|mov|shw|dst|rel|crl|pof)_[A-Za-z0-9_-]+$
data.nameRequiredstring
data.typeRequiredstring | nullValues: commercial_chain, independent, municipal, cultural,
metaRequiredobject
meta.requestIdRequiredstring
meta.generatedAtRequiredstringFormat: date-time

Errors: 400, 401, 403, 404, 429, 500, 503. Response format and retry guidance →