Skip to main content
POST
Import an existing shared identity verification
See reusable identity onboarding for consent, review and retry requirements.

Authorizations

Authorization
string
header
required

HTTP Basic auth. Username is the Stableyard app ID. Password is the app secret. The optional Stableyard-Version request header must match the environment pin.

Headers

Idempotency-Key
string
required
Required string length: 1 - 128
Stableyard-Version
enum<string>

Optional contract-version assertion. Omit it to use the app environment's pinned version. A different supported version is accepted only after that environment is explicitly migrated.

Available options:
2026-09-09

Path Parameters

accountId
string
required

Body

application/json
shareToken
string
required
write-only

Short-lived token minted for Stableyard's receiving identity application. Example is deliberately invalid.

Required string length: 100 - 8192
Pattern: ^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+$
Example:

"eyJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uX2lkIjoiMTExMTExMTEtMTExMS00MTExLTgxMTEtMTExMTExMTExMTExIiwic2Vzc2lvbl9raW5kIjoidXNlciIsImZyb21fYXBwbGljYXRpb25faWQiOiIyMjIyMjIyMi0yMjIyLTQyMjItODIyMi0yMjIyMjIyMjIyMjIiLCJmb3JfYXBwbGljYXRpb25faWQiOiIzMzMzMzMzMy0zMzMzLTQzMzMtODMzMy0zMzMzMzMzMzMzMzMiLCJpYXQiOjAsImV4cCI6MX0.synthetic_invalid_signature"

Response

Durable import and current verification state

import
object
required
verification
object
required