# Opencorporates — 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.

> Access comprehensive company registration data, officer details, and filing histories from OpenCorporates across jurisdictions worldwide to research businesses and their leadership. Search for specific companies or officers, retrieve detailed corporate information, and explore filing records to support due diligence, compliance checks, and business intelligence.

**Category:** Business Directories | **Website:** [opencorporates.com/](https://opencorporates.com/) | **Docs:** [parse.bot/marketplace/86494c36-d6c3-4bdd-99a1-7b9f500dcdc4/opencorporates-com-api](https://parse.bot/marketplace/86494c36-d6c3-4bdd-99a1-7b9f500dcdc4/opencorporates-com-api)

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

## Access

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

Retrieve full details for a specific company by jurisdiction and company number via API. Requires API token.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `api_token` | string | No | OpenCorporates API token |
| `company_number` | string | Yes | Company registration number |
| `jurisdiction_code` | string | Yes | Jurisdiction code (e.g., us_de) |
| `sparse` | string | No | Lightweight response if true |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/opencorporates/get-company \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"api_token":"<string>","company_number":"<string>","jurisdiction_code":"<string>","sparse":"<string>"}'
```

### List jurisdictions

List all jurisdictions supported by OpenCorporates via API. Requires API token.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `api_token` | string | No | OpenCorporates API token |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/opencorporates/list-jurisdictions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"api_token":"<string>"}'
```

### Scrape company page

Scrape the OpenCorporates HTML company page for registration details, officers, and filing history. No API token required, but may be blocked by hCaptcha.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company_number` | string | Yes | Company registration number |
| `jurisdiction_code` | string | Yes | Jurisdiction code (e.g., us_de) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/opencorporates/scrape-company-page \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"company_number":"<string>","jurisdiction_code":"<string>"}'
```

### Scrape officer page

Scrape the OpenCorporates HTML officer page to extract officer details and associated companies. No API token required, but may be blocked by hCaptcha.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | OpenCorporates officer ID |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/opencorporates/scrape-officer-page \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"id":"<string>"}'
```

### Search companies

Search for companies by name across all or a specific jurisdiction. Requires API token.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `api_token` | string | No | OpenCorporates API token |
| `company_type` | string | No | Filter by company type |
| `country_code` | string | No | Filter by country code |
| `current_status` | string | No | Filter by current status (e.g., Active) |
| `jurisdiction_code` | string | No | Filter by jurisdiction code (e.g., us_de) |
| `page` | integer | No | Page number for pagination |
| `query` | string | Yes | Search keyword (company name) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/opencorporates/search-companies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"api_token":"<string>","company_type":"<string>","country_code":"<string>","current_status":"<string>","jurisdiction_code":"<string>","page":"<integer>","query":"<string>"}'
```

### Search officers

Search for company officers by name via API. Requires API token.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `api_token` | string | No | OpenCorporates API token |
| `page` | integer | No | Page number |
| `query` | string | Yes | Officer name search keyword |

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

## Next steps

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