Get Account
Accounts
Get Account
Fetch a single account with its full KYB response
GET
Get Account
Fetches a single account with its full KYB response, including onboarding progress, requirements, and rejection reasons. Returns 404 if the account does not exist and 403 if the id resolves to an account owned by another organization.
Path Parameters
string
required
Platform customer id.
string
required
Account id.
Response
Returns the full account object.string
Always
account.string
Account id (e.g.
acct_3mnq7c1e6a2b4f3c9b8d2e5a).string
Platform customer id.
enum | null
Entity type:
individual or business. null until KYC starts.enum | null
Verification status:
not_started, under_review, action_needed, approved, or rejected. Newly created accounts remain not_started until the requirements returned by this endpoint are complete; Hop then starts verification review automatically.string | null
Account display name.
string | null
Primary contact email.
string | null
ISO 3166-1 alpha-2 country code. Derived from
registered_address.country.object
Onboarding state.
object
Requirement state:
complete (string[]), pending (string[]), missing (object[]), and issues (object[]). This is the preferred source for rendering the next onboarding action.object[]
Associated-person progress, including
verification_status, hosted_url, and hosted_url_expires_at when hosted verification is required.object[] | null
Review rejection reasons, populated only when
kyc_status is rejected (terminal). Null otherwise. Recoverable review requests (action_needed) appear as rfi.* entries under requirements.issues, each carrying its own reason, developer_reason, and accepted_document_types; upload the corrected document with the entry’s key as requirement_key and re-submission happens automatically. During an open request-for-information cycle, onboarding.submission_status cycles back through not_ready / ready until the corrected documents are re-submitted.string
ISO 8601 timestamp when created (standard envelope).
string
ISO 8601 timestamp when last updated (standard envelope).
string | null
Actor that created the account (standard envelope).
string | null
Actor that last updated the account (standard envelope).