# Bcorporation — 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 data from bcorporation.net.

**Category:** Business Directories | **Website:** [www.bcorporation.net/en-us/find-a-b-corp/](https://www.bcorporation.net/en-us/find-a-b-corp/) | **Docs:** [parse.bot/marketplace/95a48934-0b81-4ede-a771-3b76e41c9865/bcorporation-net-api](https://parse.bot/marketplace/95a48934-0b81-4ede-a771-3b76e41c9865/bcorporation-net-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-bcorporation-net-api-95a48934/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_company

Retrieve the full public directory profile for a single B Corp by its slug identifier. Returns comprehensive data including description, headquarters and operating locations, certification status and dates, overall and per-area B Impact scores (Governance, Workers, Community, Environment, Customers), historical scores, standards version, and website. The slug is the URL-safe identifier returned in search results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | URL-safe company identifier as returned by search_companies (e.g. 'patagonia-inc', 'thread-coffee-roasters'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bcorporation-net-api-95a48934/get_company \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### search_companies

Full-text search over the B Corp directory. Matches against company name, description, keywords, location, industry, and sector. Optionally filter by headquarters country or industry. Results are ordered by relevance when a query is provided, or newest-first when browsing all companies. Each result includes certification status, date, overall B Impact score, headquarters location, and operating countries.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Filter by headquarters country name exactly as listed in the directory (e.g. 'United States', 'United Kingdom', 'Netherlands The'). |
| `industry` | string | No | Filter by industry name exactly as listed in the directory (e.g. 'Apparel', 'Food products', 'Software publishing and SaaS platforms'). |
| `page` | integer | No | Page number for pagination (1-based). |
| `per_page` | integer | No | Number of results per page (1-250). |
| `query` | string | No | Search keyword(s) matched against company name, description, website keywords, location, industry, and sector. Empty string or omitted returns all companies. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bcorporation-net-api-95a48934/search_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","industry":"<string>","page":"<integer>","per_page":"<integer>","query":"<string>"}'
```