SOS Reports

Order and retrieve Secretary of State filing reports for US company verification and compliance checks using the iDenfy KYB API tools.

Requirements

• API key pair
• Reports functionality enabled (done by iDenfy’s staff)

---

Ordering SOS Document

Authorization: API key pair Method: POST Endpoint: https://ivs.idenfy.com/api/v2/sos-filing-documents/

Request structure

Parameter	Type	Required
companyName	String	Yes
state	String	Yes
city	String	Yes
street	String	Yes
postalCode	String	Yes

The ordered report takes time to generate and will initially have status IN_PROGRESS.

Request example

{
  "companyName": "City and Borough of Juneau",
  "state": "AK",
  "city": "Juneau",
  "street": "155 S Seward St",
  "postalCode": "99801"
}

---

List Documents

Authorization: API key pair Method: GET Endpoint: https://ivs.idenfy.com/api/v2/sos-filing-documents/

Request structure

Query Parameter	Type	Explanation
checkedAt	Array of strings <date-time>	Date-time filter for checked documents
status	String	Enum: FAILED, FINISHED, IN_PROGRESS, NOT_ORDERED, TIMED_OUT