Solo Accounts

Get a solo creator account

The source of truth for account state. Webhooks are the fast path; this is what you use to render a "finish setting up" prompt or to reconcile after an outage. While the account is pending it returns a currently valid onboardingUrl, rotated automatically if the old link expired.

get/api/v1/solo-accounts/{accountId}

Request

  • Base URL: https://easy2257.com
  • URL: https://easy2257.com/api/v1/solo-accounts/{accountId}
  • Auth: HTTP bearer

Path parameters

accountIdstring required
Example:cmd4k2x9p0001qz8h3v7ftg2a

Response

Account found.

accountIdstring required
externalUserIdstring required

The id you supplied at provisioning. Returned on reads so you can reconcile without a local join.

status'pending_id_verification' | 'subscribed_pending_id' | 'active' | 'suspended' required

The four values a partner can observe. pending_id_verification: not finished. This one value covers every pre-active state, including an emailed link request that has not been answered, so account existence and consent decisions are never observable through the API. subscribed_pending_id: paid, ID not yet verified. Still not uploadable. active: paid and ID verified. This is the only value that unlocks uploads. suspended: not in custody right now. Revoke upload access. suspendReason says why: the creator's own subscription lapsed, your platform fee lapsed, Easy2257 suspended them, or you deactivated them through POST .../deactivate.

createdAtstring date-time required
onboardingUrlstring uri

Present while the account is still pending, and always currently valid: an expired token is rotated on read.

verifiedAtstring date-time
suspendedAtstring date-time
suspendReasonstring

Why the account is suspended, absent otherwise. subscription_lapsed: the creator's own subscription ended; it clears when they pay again. platform_lapsed: your platform fee lapsed; it clears when the fee is paid. partner_deactivated: you deactivated the creator through POST .../deactivate or the portal roster; only POST .../reactivate clears it. platform_deactivated and manual_suspension: Easy2257 suspended the account; contact Easy2257.

complianceStatementUrlstring uri

The creator's public 2257 statement. Present once the account is active and the creator has published the statement, absent otherwise, so the value is always a live page rather than a link that 404s. This is the page the platforms guide asks you to link from every content page carrying their content, which is also the only point at which you should be hosting that content.

Example response

{
  "accountId": "cmd4k2x9p0001qz8h3v7ftg2a",
  "externalUserId": "user_12345",
  "createdAt": "2026-04-22T11:00:00Z",
  "onboardingUrl": "https://easy2257.com/partner-onboard/9f2c...",
  "verifiedAt": "2026-04-22T13:00:00Z",
  "suspendReason": "subscription_lapsed",
  "complianceStatementUrl": "https://easy2257.com/producer/acme-media/2257-statement"
}

Changes

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