# Finra — 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 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/finra/`
**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

### 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.beta.paywithlocus.com/api/wrapped/credits/finra/list-firms-alphabetical \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/finra/search-broker-firms \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/finra/search-broker-individuals \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/finra/search-disciplinary-actions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<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.