Skip to content
Seismic Orchestration

GET /org/kyb/state

The current KYB state for the org: what's done, what's pending, what's missing.

This endpoint does not hit any external system: it returns the cached state, updated on submit, on webhook receipt, and on explicit POST /resync calls. last_synced_at reflects the freshness.

Response 200

{
  "kyb_status": "under_review",
  "kyb_link": {
    "url": "https://onboarding.example.com/...",
    "expires_at": "2026-04-25T11:00:00Z"
  },
  "missing_fields": ["documents.incorporation_certificate"],
  "last_synced_at": "2026-04-24T08:00:00Z",
  "rejection_reason": null,
  "pending_rfi": false,
  "last_submitted_at": "2026-04-23T11:00:00Z",
  "resubmit_available": false
}

See KybState.

Example

curl "$SEISMIC_ORCHESTRATION_URL/v0/org/kyb/state" \
  -H "Api-Key: $SEISMIC_ORCHESTRATION_API_KEY"