Kaaj SOS API

This document describes the API endpoint for submitting SOS (Secretary of State) information. This is an asynchronous API.

Endpoint

POST https://api.kaaj.ai/application/sos-trigger

Headers

Authorization: Bearer <your_api_key>

Request Body

JSON body with the following fields:

Field Name	Type	Required	Description
appId	string	Yes	Unique identifier for the application/form
businessName	string	Yes	Legal name of the business
incorporationState	string	Yes	State where the business is incorporated

Response

Initial Success Response

• Code: 200 OK
• Content:

Field Name	Type	Description
status	string	Status of the request (e.g., "started")
workflow_id	string	Unique identifier for the workflow process

Sample Initial Response

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

Final Response (via callback or separate endpoint)

When the asynchronous process completes, the following data will be available:

Field Name	Type	Description
name	string	Legal name of the business entity
entity_type	string	Type of business entity (e.g., LLC, Corporation)
filing_number	string	Official filing number assigned by the state
filing_date	string	Date when the entity was filed/registered
status	string	Current status of the business entity
registered_agent	string	Name of the registered agent for the business
address	string	Official address of the business entity
appId	string	Unique identifier for the application/form (as input)
businessName	string	Legal name of the business (as input)
incorporationState	string	State where the business is incorporated (as input)
recordId	string	Unique identifier for the record (as input)
is_exact_match	boolean	Indicates if the result is an exact match to the query

Sample Final Response

{
  "appId": "test1",
  "businessName": "ACME BAR & GRILL, L.L.C.",
  "incorporationState": "Illinois",
  "recordId": "rec_12345",
  "name": "ACME BAR & GRILL, L.L.C.",
  "entity_type": null,
  "filing_number": "00077356",
  "filing_date": "1996-07-26",
  "status": "Involuntary Dissolution",
  "registered_agent": null,
  "address": "2300-18TH AVENUE, , Rock Island, IL, 61201",
  "principals": "",
  "is_exact_match": true
}

Error Response

• Code: 400 Bad Request
• Content:

  {
    "message": "One of the following fields is missing - 'appId', 'businessName', 'incorporationState'"
  }

Notes

• All required fields must be provided in the request body.
• The API key must be included in the Authorization header for authentication.
• This is an asynchronous API. The initial response only confirms that the request has been accepted for processing.
• The final result will be available through a callback mechanism or a separate endpoint using the provided workflow_id.
• The server logs the API call, including the request body and headers.
• The final response includes detailed information about the business entity, including whether it's an exact match to the provided business name.