v2.accounts

Retrieve an API onboarding by its cooud_onb_ id (platform key)

Platform keys only. The onboarding a POST /accounts started, by the id every 202 returns (also in Location): the same account_onboarding as GET /accounts/{id}/onboarding, readable before the store exists. Scoped to the platform AND the environment of the key: an id of another platform, of the other environment, malformed or unknown is the same 404. Unlike GET /accounts/{id}/onboarding, a sandbox key does not read the platform's live onboardings here: each key reads only the onboardings of its own environment.

get/account_onboardings/{id}

Request

  • Base URL: https://api.cooud.com/v2
  • URL: https://api.cooud.com/v2/account_onboardings/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

cooud_onb_<ULID> from the 202 of POST /accounts.

Headers

Cooud-Compat-Datestring date required

Required per-request compat-date. Format: ISO calendar date YYYY-MM-DD. Merchants pinned to an older date have their request and response transformed by every gate whose appliesAfter is strictly greater than this date.

Response

The onboarding state.

object'account_onboarding' required
idstring required

cooud_onb_<ULID>: this onboarding, readable at GET /account_onboardings/{id}. Present on every 202 — also before the store exists, when account is still null.

accountstring nullable required

cooud_acct_<store ULID> once the store step completed; null before.

emailstring nullable required

On the 202 of POST /accounts, the e-mail of the request; on GET /account_onboardings?email=, the e-mail looked up (trimmed, lower case), for a simulated onboarding too; on GET /account_onboardings/{id} and GET /accounts/{id}/onboarding, the store owner of record — null when the store has no owner yet, and always null for a simulated sandbox onboarding (only the e-mail hash is kept).

business_type'individual' | 'company' required
step'created' | 'user' | 'store' | 'stripe_account' | 'kyc' | 'bank' | 'documents' | 'terms' | 'membership' | 'done' required

The last completed step.

state'in_progress' | 'incomplete' | 'done' | 'failed' required

in_progress (a request holds it), incomplete (repeat the POST to resume), done, failed (the seller belongs to another platform).

next_step'user' | 'store' | 'stripe_account' | 'kyc' | 'bank' | 'documents' | 'terms' | 'membership' | 'done' nullable required

The step a repeated POST /accounts runs next; null when done.

livemodeboolean required

false when the onboarding was simulated under a sandbox key.

metadataobject required
createdinteger required

Unix epoch seconds.

request_idstring required

Changes

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