---
title: "Get a solo creator account"
method: GET
path: "/api/v1/solo-accounts/{accountId}"
tags: ["Solo Accounts"]
---

# Get a solo creator account

`GET /api/v1/solo-accounts/{accountId}`

## Request

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

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.

## Path parameters

- `accountId` string, required

## Response `200`

Account found.

- object: The only creator-identifying value here is the public statement URL, which the creator published themselves. No legal name, no date of birth, no ID image, no Easy2257 user id, not even the email you provisioned with.
  - `accountId` string, required
  - `externalUserId` string, 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`.
  - `createdAt` string, date-time, required
  - `onboardingUrl` string, uri: Present while the account is still pending, and always currently valid: an expired token is rotated on read.
  - `verifiedAt` string, date-time
  - `suspendedAt` string, date-time
  - `suspendReason` string: 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.
  - `complianceStatementUrl` string, 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.

## Other responses

- `400`: Invalid request: a required field is missing or malformed.
- `401`: No `Authorization: Bearer` header, or a key that is unknown, revoked, or expired. The body carries only `error`, never a `code`.
- `403`: Rejected before the handler: a test-mode key (`TEST_MODE_UNAVAILABLE`) or a partner account that is not ACTIVE. Never used for cross-partner access, which returns 404.
- `404`: No such account, or it belongs to another partner. The two cases are indistinguishable on purpose, so the API cannot be used to enumerate accounts.
- `429`: Rate limit exceeded: 300 requests per 60 seconds per API key, shared across all `/api/v1` endpoints (requests without a `Bearer` key fall back to 60 per 60 seconds per client IP, and a per-address flood ceiling of 1200 per 60 seconds also applies). Honor `Retry-After`.
- `500`: Server error. Retry with exponential backoff.

---

[API](https://skmtc.dev/easy2257/apis/easy2257-partner-api.md) · [All operations](https://skmtc.dev/easy2257/apis/easy2257-partner-api/llms.txt) · [OpenAPI document](https://skmtc.dev/easy2257/apis/easy2257-partner-api/revisions/f880026c1f04?raw)