---
title: "Get production status"
method: GET
path: "/api/v1/productions/{productionId}"
tags: ["Productions"]
---

# Get production status

`GET /api/v1/productions/{productionId}`

## Request

- Base URL: `https://easy2257.com`
- URL: `https://easy2257.com/api/v1/productions/{productionId}`
- Auth: HTTP bearer

Current compliance status of one production, plus the custodian identity you can print on a records statement. Scoped to productions linked to your partner account: anything else returns 404.

## Path parameters

- `productionId` string, required

## Response `200`

Production found.

- ProductionResponse
  - `id` string, required
  - `status` 'pending_documentation' | 'documented' | 'revoked' | 'takedown_pending' | 'takedown_complete', required: `pending_documentation`: records not yet complete. `documented`: records on file and a certificate issued. `revoked`: certificate revoked by an actioned takedown. `takedown_pending`: removal request received, under review. `takedown_complete`: content removed, records sealed.
  - `performerCount` integer, required: Number of talent participants across the production's scenes.
  - `documentedAt` string, date-time, nullable, required
  - `custodianName` string, required: Custodian of Records legal entity, exactly as published on the Easy2257 records statement. Render it, do not parse it.
  - `custodianAddress` string, required: Custodian mailing address on one line. Empty string when no address is on file.
  - `takedownContact` string, email, required
  - `lastVerifiedAt` string, date-time, required: Timestamp of this lookup, not of a stored verification event. Useful as an audit breadcrumb for when you last checked.

## Other responses

- `400`: Invalid request: a required field is missing or malformed.
- `401`: No `Authorization: Bearer` header, or a key that is unknown, revoked, or expired. The body carries only `error`, never a `code`.
- `403`: Rejected before the handler: a test-mode key (`TEST_MODE_UNAVAILABLE`) or a partner account that is not ACTIVE. Never used for cross-partner access, which returns 404.
- `404`: No such production, or it is not linked to your partner account.
- `429`: Rate limit exceeded: 300 requests per 60 seconds per API key, shared across all `/api/v1` endpoints (requests without a `Bearer` key fall back to 60 per 60 seconds per client IP, and a per-address flood ceiling of 1200 per 60 seconds also applies). Honor `Retry-After`.
- `500`: Server error. Retry with exponential backoff.

---

[API](https://skmtc.dev/easy2257/apis/easy2257-partner-api.md) · [All operations](https://skmtc.dev/easy2257/apis/easy2257-partner-api/llms.txt) · [OpenAPI document](https://skmtc.dev/easy2257/apis/easy2257-partner-api/revisions/f880026c1f04?raw)