Skip to main content
POST
Complete verification with the one-time authorization code
Completes a verification that returned verification_pending: pass the one-time authorization code the firm received on its registered email and mobile. On success the firm’s state is connected and it can trade. A wrong code keeps the firm in verification_pending so the firm can re-read and you can retry; lockout policy is owned server-side, never guess-loop.

Request example

Response example

Errors

  • 409 conflict, the firm is not awaiting an authorization code (already connected, or verify was never called).
  • 422 unprocessable, missing code.
Terms used here: IEC, connection state, API key. Full list in the terminology annexure.

Next steps

Authorizations

X-ScripX-Key
string
header
required

Your API key, e.g. scripx_live_…. Bound to one firm; tenant isolation is enforced.

Path Parameters

iec
string
required

Body

application/json
code
string
required

the one-time authorization code the firm received

Response

OK

firm
object