Trigger SOS verification

​

Submit a Secretary of State (SOS) lookup. This is an asynchronous API.

The initial response confirms the request was accepted. Final results are available through a callback or a separate endpoint using the returned workflow_id.

Body·SosTriggerRequest

required
application/json
  • appId
    Type: string
    required
  • businessName
    Type: string
    required
  • incorporationState
    Type: string
    required

Responses

  • application/json
  • 401

    Missing or invalid Bearer token. Response body is empty.

  • application/json
  • application/json
  • application/json
Request Example for post/application/sos-trigger
curl https://api.kaaj.ai/application/sos-trigger \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "appId": "Kaaj-app-1",
  "businessName": "Kaaj-business-1",
  "incorporationState": "XX"
}'

{
  "status": "started",
  "workflow_id": "7d901614-abf3-4bd6-b51f-cbe295821daf"
}

SOS workflow started