# Search Sunbiz — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 the Florida Sunbiz corporate registry to find detailed business registration information by company name, officer, address, or EIN, and retrieve complete entity details including filing history, registered agents, and officer names.

**Category:** Government & Public Data | **Website:** [search.sunbiz.org/](https://search.sunbiz.org/) | **Docs:** [parse.bot/marketplace/7e4adece-9b82-492e-bcfb-0408c704385a/search-sunbiz-org-api](https://parse.bot/marketplace/7e4adece-9b82-492e-bcfb-0408c704385a/search-sunbiz-org-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/search-sunbiz/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get entity detail

Retrieve full details for a specific entity using the detail_url obtained from a search result. Returns entity type, filing information, addresses, registered agent, and officer/director details. Each detail page is a separate fetch; use sparingly to avoid rate limits.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `detail_url` | string | Yes | Full detail URL from a search result's detail_url field (e.g. from search_by_entity_name results) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/search-sunbiz/get-entity-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"detail_url":"<string>"}'
```

### List cable franchises

List all cable franchises registered in Florida alphabetically by name. Returns franchise name and franchise number. The full list typically fits on one page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/search-sunbiz/list-cable-franchises \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### Search by address

Search for entities by street address. Returns matching entities with name, document number, status, street address, and detail_url.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | Yes | Street address to search for (e.g. '1600 Amphitheatre') |
| `limit` | integer | No | Maximum number of results to return |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/search-sunbiz/search-by-address \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>","limit":"<integer>"}'
```

### Search by entity name

Search for corporations, LLCs, and other entities by name. Returns a paginated list of matching entities with their document number, status, and a detail_url for retrieving full information via get_entity_detail. Results are ordered alphabetically starting from the search term.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return |
| `name` | string | Yes | Entity name to search for (e.g. 'Google') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/search-sunbiz/search-by-entity-name \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","name":"<string>"}'
```

### Search by fei ein

Search for entities by Federal Employer Identification Number (FEI/EIN). Returns matching entities with the FEI/EIN, document number, corporate name, and detail_url.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fein` | string | Yes | FEI/EIN number to search for (e.g. '770493581') |
| `limit` | integer | No | Maximum number of results to return |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/search-sunbiz/search-by-fei-ein \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"fein":"<string>","limit":"<integer>"}'
```

### Search by officer

Search for entities by officer or registered agent name. Returns matching entities with officer name, entity name, document number, and detail_url for retrieving full information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return |
| `name` | string | Yes | Officer or registered agent name to search for (e.g. 'Smith') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/search-sunbiz/search-by-officer \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","name":"<string>"}'
```

### Search by zip

Search for entities registered in a specific ZIP code. Returns matching entities with name, document number, status, zip code, and detail_url.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return |
| `zip_code` | string | Yes | ZIP code to search for (e.g. '33101') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/search-sunbiz/search-by-zip \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","zip_code":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.