# Finra — 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 FINRA disciplinary actions and BrokerCheck records to verify the background, credentials, and regulatory history of broker firms and individual financial professionals. Look up broker information alphabetically or by specific criteria to research potential advisors and ensure they have a clean compliance record.

**Category:** Finance & Markets | **Website:** [finra.org/](https://finra.org/) | **Docs:** [parse.bot/marketplace/cdfc56b2-bd12-4911-8159-fac648b7e5c8/finra-org-api](https://parse.bot/marketplace/cdfc56b2-bd12-4911-8159-fac648b7e5c8/finra-org-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-finra-org-api-cdfc56b2/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### list_firms_alphabetical

List firms alphabetically by a single letter (A-Z). Delegates to the BrokerCheck firm search with the letter as the query. Useful for enumerating all registered firms. Supports pagination via offset/limit.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `letter` | string | No | Single letter (A-Z) for alphabetical listing. |
| `limit` | integer | No | Number of firms per page. |
| `offset` | integer | No | Starting index for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-finra-org-api-cdfc56b2/list_firms_alphabetical \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"letter":"<string>","limit":"<integer>","offset":"<integer>"}'
```

### search_broker_firms

Search for broker-dealer or investment adviser firms by name or CRD number via the BrokerCheck API. Returns firm details including address, registration status, branch count, and disclosure information. Supports pagination via offset/limit.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results to return (max 100). |
| `offset` | integer | No | Starting index for pagination. |
| `query` | string | Yes | Firm name or CRD number to search for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-finra-org-api-cdfc56b2/search_broker_firms \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","query":"<string>"}'
```

### search_broker_individuals

Search for individual brokers or financial advisers by name or CRD number via the BrokerCheck API. Returns individual details including employment history, registration count, and disclosure status. Supports pagination via offset/limit.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results to return. |
| `offset` | integer | No | Starting index for pagination. |
| `query` | string | Yes | Individual name or CRD number to search for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-finra-org-api-cdfc56b2/search_broker_individuals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","query":"<string>"}'
```

### search_disciplinary_actions

Search FINRA disciplinary actions by keyword or phrase. Returns paginated results (15 per page) including respondent names, case summaries, action dates, and links to PDF documents. When no query is provided, returns the most recent actions. Pagination is 0-indexed.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (0-indexed). Each page contains up to 15 results. |
| `query` | string | No | Search keyword or phrase (e.g. 'fraud', 'insider trading'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-finra-org-api-cdfc56b2/search_disciplinary_actions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```