> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.idenfy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SOS Reports

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

<Note>
  **Requirements**

  * **API** key pair
  * Reports functionality **enabled** (done by iDenfy's staff)
</Note>

<Info>
  **Sample reports:** [Download here](/images/preview/ReportSamples.zip)
</Info>

***

## Ordering SOS Document

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

**Request structure**

| Parameter     | Type   | Required |
| ------------- | ------ | -------- |
| `companyName` | String | Yes      |
| `state`       | String | Yes      |
| `city`        | String | Yes      |
| `street`      | String | Yes      |
| `postalCode`  | String | Yes      |

<Warning>
  The ordered report takes time to generate and will initially have status `IN_PROGRESS`.
</Warning>

**Request example**

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

***

## List Documents

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

**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` |