# Idoi — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for licensed insurance producers, agents, agencies, and public adjusters in Illinois while accessing their professional credentials and contact information. Quickly verify agent licensing status and retrieve detailed practitioner details through comprehensive site-wide search capabilities.

**Category:** Government & Public Data | **Website:** [idoi.illinois.gov/](https://idoi.illinois.gov/) | **Docs:** [parse.bot/marketplace/7220b820-b550-45ff-8de0-6669bf7b8b9e/idoi-illinois-gov-api](https://parse.bot/marketplace/7220b820-b550-45ff-8de0-6669bf7b8b9e/idoi-illinois-gov-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-idoi-illinois-gov-api-7220b820/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_producer_details

Retrieve full details for a producer including demographics, contact info, lines of authority, appointments, and CE info. Uses the license number to look up the producer in the NAIC SBS system.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `entity_type` | string | No | Entity type: 'IND' for individuals, 'BE' for business entities/agencies. |
| `license_number` | string | Yes | Illinois license number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-idoi-illinois-gov-api-7220b820/get_producer_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"entity_type":"<string>","license_number":"<string>"}'
```

### search_producers

Search for insurance producers, agencies, and adjusters licensed in Illinois. Supports filtering by name, license number, NPN, and license type. At least one of last_name, license_number, or npn must be provided.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `entity_type` | string | No | Entity type: 'IND' for individuals, 'BE' for business entities/agencies. |
| `first_name` | string | No | First name of the producer. |
| `last_name` | string | No | Last name or business name of the licensee. Required unless license_number or npn is provided. |
| `license_number` | string | No | Illinois license number. |
| `license_type` | string | No | License type code: 'PRO' for Producer, 'TMP' for Temporary Producer, 'PAD' for Public Adjuster, 'NAV' for Navigator. |
| `npn` | string | No | National Producer Number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-idoi-illinois-gov-api-7220b820/search_producers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"entity_type":"<string>","first_name":"<string>","last_name":"<string>","license_number":"<string>","license_type":"<string>","npn":"<string>"}'
```

### search_site

Perform a keyword search across the IDOI website to find bulletins, reports, regulations, and general content pages. Returns paginated results with title, description, path, and content snippets.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Results page number. |
| `query` | string | Yes | Search query keywords. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-idoi-illinois-gov-api-7220b820/search_site \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```