> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firmable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Partner API

> Firmable company and contact data for partner platforms

The Partner API gives your platform Firmable company and contact data across 13 markets. Your users
search for companies and people, then enrich the records they choose with contact details.

| | |
| - | - |
| **Base URL** | `https://api.firmable.com` |
| **Partner path** | `/partner/{partner}/…` |
| **Authentication** | `Authorization: Bearer …` |

`{partner}` is your platform's identifier. Firmable gives it to you during onboarding.

## Endpoints

The Partner API has six endpoints.

| Endpoint | Returns |
| - | - |
| [People enrichment](https://docs.firmable.com/partner/people-enrichment.md) | One person's full profile, including contact details |
| [Company enrichment](https://docs.firmable.com/partner/company-enrichment.md) | One company's full profile for one market, including contact details |
| [Company search](https://docs.firmable.com/partner/company-search.md) | Companies matching structured filters |
| [People search](https://docs.firmable.com/partner/people-search.md) | People matching structured filters, including filters on their employer |
| [People in company search](https://docs.firmable.com/partner/people-in-company-search.md) | The people at one company |
| [Filter options](https://docs.firmable.com/partner/filter-options.md) | The codes each search filter accepts |

Search returns no phone numbers or email addresses. Search results show whether Firmable holds them.
Contact details come from the enrichment endpoints.

## Authentication

Send your key in the `Authorization` header as a bearer token:

```bash theme={null}
curl "https://api.firmable.com/partner/{partner}/people/enrich?id=fp000000000201&required=either" \
  -H "Authorization: Bearer $FIRMABLE_KEY"
```

## Markets

Firmable covers 13 markets:

| Code | Market |
| - | - |
| `AU` | Australia |
| `NZ` | New Zealand |
| `SG` | Singapore |
| `MY` | Malaysia |
| `ID` | Indonesia |
| `PH` | Philippines |
| `TH` | Thailand |
| `VN` | Vietnam |
| `HK` | Hong Kong |
| `JP` | Japan |
| `KR` | South Korea |
| `US` | United States |
| `CA` | Canada |

> [!NOTE]
>
> Sample records in the Partner API docs are fictional.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.