Collab Scenes

Get a collab scene

Current scene status and consent progress. Prefer webhooks for real-time signals and use this for dashboards and reconciliation. Visible to the partner that created the scene and to any partner that has registered a publication on it. Publications in the response are scoped to you. The body depends on which of those you are: the creating partner gets the performer roster and the fee block as well as the counts, because it supplied those addresses and paid those fees; a partner holding only a publication gets the counts, matching what POST /extend returns.

get/api/v1/collab-scenes/{sceneId}

Request

  • Base URL: https://easy2257.com
  • URL: https://easy2257.com/api/v1/collab-scenes/{sceneId}
  • Auth: HTTP bearer

Path parameters

sceneIdstring required
Example:cmd5r9a4t0001qz8hb6k2m3xd

Response

Scene found.

sceneIdstring required
status'pending_signatures' | 'greenlit' | 'blocked' | 'cancelled' required

pending_signatures: waiting on performers. greenlit: everyone signed and every new performer passed ID verification. This is the only status that permits publication. blocked: a performer refused, or the 14-day window lapsed. cancelled: cancelled through the API. No refund.

performerCountinteger required
consentedCountinteger required
releaseSignedCountinteger required

Same field POST /extend returns, so release progress reads the same way on both endpoints.

refusedCountinteger required
expiresAtstring date-time required

Example response

{
  "sceneId": "cmd5r9a4t0001qz8hb6k2m3xd",
  "performerCount": 3,
  "consentedCount": 2,
  "releaseSignedCount": 1,
  "performers": [
    {
      "email": "performer@example.com"
    }
  ],
  "fees": {
    "sceneFeeCents": 500,
    "onboardingFeeCents": 2500,
    "totalCents": 3000,
    "stripeChargeId": "pi_3NabcDEfghIJklmn",
    "billedTo": "uploader_card"
  },
  "publications": [
    {
      "id": "cmd5rc1v90007qz8h4p8w2n6y",
      "contentUrl": "https://your-platform.com/post/12345"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.