# Arc Sos State — 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 and retrieve detailed information about Alabama business entities, including their registration status, agents, officers, and incorporators. Verify if a business exists and look up specific company details by name or associated contacts.

**Category:** Government & Public Data | **Website:** [arc-sos.state.al.us/](https://arc-sos.state.al.us/) | **Docs:** [parse.bot/marketplace/b04438da-b5a6-4b14-9cfb-37160e61995a/arc-sos-state-al-us-api](https://parse.bot/marketplace/b04438da-b5a6-4b14-9cfb-37160e61995a/arc-sos-state-al-us-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-arc-sos-state-al-us-api-b04438da/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### check_entity_exists

Check if a specific entity ID exists in the Alabama Secretary of State database. Returns a boolean existence flag and the queried entity ID.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `entity_id` | string | Yes | The 9-digit entity ID, leading zeros preserved. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-arc-sos-state-al-us-api-b04438da/check_entity_exists \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"entity_id":"<string>"}'
```

### get_entity_detail

Get detailed information for a specific business entity by its 9-digit ID. Returns entity details including legal name, type, status, formation date, registered agent, addresses, transactions, and scanned documents. Each entity has a unique 9-digit identifier with preserved leading zeros.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `entity_id` | string | Yes | The 9-digit entity ID, leading zeros preserved (e.g., 000210236). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-arc-sos-state-al-us-api-b04438da/get_entity_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"entity_id":"<string>"}'
```

### scrape_entity_range

Retrieve full entity details for a sequential range of entity IDs. Optionally filter results to only entities whose formation date falls within January 2024 to July 2025. Range is capped at 50 entities per call.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `end_id` | string | No | Ending entity ID in the range (9-digit, leading zeros preserved). |
| `filter_dates` | boolean | No | When true, filters results to entities whose formation date falls within January 2024 to July 2025. |
| `start_id` | string | No | Starting entity ID in the range (9-digit, leading zeros preserved). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-arc-sos-state-al-us-api-b04438da/scrape_entity_range \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"end_id":"<string>","filter_dates":"<boolean>","start_id":"<string>"}'
```

### search_by_agent_officer_incorporator

Search for business entities by registered agent, officer, or incorporator name. Returns up to 25 results per page with entity ID, entity name, agent name, and position.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | Yes | Name of the agent, officer, or incorporator. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-arc-sos-state-al-us-api-b04438da/search_by_agent_officer_incorporator \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"<string>"}'
```

### search_by_entity_name

Search for business entities by name. Returns up to 25 results per page with entity ID, name, location, type, and status. Pagination is supported via the start parameter which advances by 25 per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | Yes | Search query for entity name. |
| `start` | integer | No | Starting index for pagination (1-based, advances by 25 per page). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-arc-sos-state-al-us-api-b04438da/search_by_entity_name \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"<string>","start":"<integer>"}'
```