Get Solo Account
GET /api/v1/solo-accounts/{accountId}: retrieve account status.
This response carries no identity data. No legal name, no date of birth, no ID image, no Easy2257 user id, not even the email you provisioned with. Your entire identifier surface is accountId plus your own externalUserId. The one creator-published value it does return is complianceStatementUrl, the public 2257 statement page you are asked to link from your content pages; it appears once the account is active and the creator has published that page.
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/solo-accounts/cmd4k2x9p0001qz8h3v7ftg2a"{
"accountId": "cmd4k2x9p0001qz8h3v7ftg2a",
"externalUserId": "user_12345",
"status": "pending_id_verification",
"createdAt": "2026-04-22T11:00:00Z",
"onboardingUrl": "https://easy2257.com/partner-onboard/9f2c...",
"verifiedAt": "2026-04-22T13:00:00Z",
"suspendedAt": "2019-08-24T14:15:22Z",
"suspendReason": "subscription_lapsed",
"complianceStatementUrl": "https://easy2257.com/producer/acme-media/2257-statement"
}{
"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"
}