Get Collab Scene
GET /api/v1/collab-scenes/{sceneId}: retrieve scene status and consent progress.
What you get back depends on whether you created this scene. Both audiences receive performerCount, consentedCount, releaseSignedCount and refusedCount. The creating partner also receives the performers roster and the fees block, because it supplied those addresses and paid those fees. A partner that reached the scene by extending somebody else's receives the counts only, the same policy POST /extend has always applied. Treat performers and fees as optional in your client.
Authorization
BearerAuth 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
Path Parameters
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://easy2257.com/api/v1/collab-scenes/cmd5r9a4t0001qz8hb6k2m3xd"{
"sceneId": "cmd5r9a4t0001qz8hb6k2m3xd",
"status": "pending_signatures",
"performerCount": 3,
"consentedCount": 2,
"releaseSignedCount": 1,
"refusedCount": 0,
"performers": [
{
"email": "performer@example.com",
"status": "pending_consent"
}
],
"fees": {
"sceneFeeCents": 500,
"onboardingFeeCents": 2500,
"totalCents": 3000,
"charged": true,
"stripeChargeId": "pi_3NabcDEfghIJklmn"
},
"expiresAt": "2019-08-24T14:15:22Z",
"publications": [
{
"id": "cmd5rc1v90007qz8h4p8w2n6y",
"contentUrl": "https://your-platform.com/post/12345",
"publishedAt": "2019-08-24T14:15:22Z",
"removedAt": "2019-08-24T14:15:22Z"
}
]
}{
"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": "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"
}