# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-opencorporates-com-api-86494c36/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-opencorporates-com-api-86494c36/get_company \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-opencorporates-com-api-86494c36/list_jurisdictions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-opencorporates-com-api-86494c36/scrape_company_page \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-opencorporates-com-api-86494c36/scrape_officer_page \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-opencorporates-com-api-86494c36/search_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-opencorporates-com-api-86494c36/search_officers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api_token":"<string>","page":"<integer>","query":"<string>"}'
```