Easy2257
API Reference

List Productions

GET /api/v1/productions?performerEmail=: list productions a performer is documented in.

This is your right-to-removal lookup. When a performer asks to be removed, one call returns every production on your platform they appear in, so you can action the request inside the legal window instead of hunting through your own catalog.

status defaults to documented. A removal sweep that needs everything must pass the status it wants explicitly.

GET
/api/v1/productions

Authorization

BearerAuth
AuthorizationBearer <token>

Partner API key from partner.easy2257.com/api-keys. Only ez_live_ keys are accepted. A key beginning with ez_test_ is rejected with 403 and code TEST_MODE_UNAVAILABLE before any handler runs: there is no sandbox, and every handler writes production records, provisions real users, and sends real email. New partner accounts start with a test key, so create a live key before your first call.

In: header

Query Parameters

performerEmail*string

Required. Matched case-insensitively.

Formatemail
status?string

Filter by documentation status. Defaults to documented, so pass an explicit value to see anything else.

Value in"pending_documentation" | "documented" | "revoked" | "takedown_pending" | "takedown_complete"
limit?string

1 to 200. Default 50.

cursor?string

nextCursor from the previous page.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://easy2257.com/api/v1/productions?performerEmail=performer%40example.com"
{
  "productions": [
    {
      "id": "cmd3p8w1k0002qz8h9j4r7v5s",
      "sceneTitle": "April 2026 Scene",
      "status": "pending_documentation",
      "documentedAt": "2019-08-24T14:15:22Z"
    }
  ],
  "nextCursor": "cmd3p8w1k0002qz8h9j4r7v5s"
}
{
  "error": "email, externalUserId, and callbackUrl are required",
  "code": "missing_parameter",
  "field": "contentType"
}
{
  "error": "email, externalUserId, and callbackUrl are required",
  "code": "missing_parameter",
  "field": "contentType"
}
{
  "error": "email, externalUserId, and callbackUrl are required",
  "code": "missing_parameter",
  "field": "contentType"
}
{
  "error": "Too many requests. Please slow down.",
  "retryAfter": 14,
  "limit": 60,
  "remaining": 0,
  "reset": 1714000060000
}
{
  "error": "email, externalUserId, and callbackUrl are required",
  "code": "missing_parameter",
  "field": "contentType"
}