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

# Match and discover organizations

> Resolve an organization name to a canonical RevenueBase record, or search for organizations by keyword and location using the Organization Match API.

Organization Match gives you two ways to find organizations: resolve a specific name to a canonical record, or search by keyword to build a list.

## Choose the right endpoint

|              | Resolve                                                        | Discovery                                                        |
| ------------ | -------------------------------------------------------------- | ---------------------------------------------------------------- |
| **Use when** | You have an organization name and want to confirm or enrich it | You want organizations matching a keyword, theme, or description |
| **Endpoint** | `POST /v2/organization/resolve`                                | `POST /v2/organization/discover`                                 |
| **Input**    | Organization name + optional headquarter info                  | Keyword + optional headquarter-related filters                   |
| **Best for** | CRM enrichment, deduplication, normalizing messy data          | Prospecting, building targeted account lists                     |

## Resolve an organization name

Send an organization name (and optionally a location) to get back matching canonical records with firmographic data.

```bash theme={null}
curl -X POST https://api.revenuebase.ai/v2/organization/resolve \
  -H "x-key: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "company_name": "Acme Corp",
    "headquarters_city": "San Francisco",
    "headquarters_state": "CA",
    "result_count": 3
  }'
```

Use `result_count` to return multiple candidates when a name is ambiguous — then select the best match on your end.

## Search organizations by keyword

Use discovery to find organizations matching a theme, industry, or free-text description.

```bash theme={null}
curl -X POST https://api.revenuebase.ai/v2/organization/discover \
  -H "x-key: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "ambulatory care facilities",
    "headquarters_state": "TX",
    "result_count": 10
  }'
```

Results include organization identifiers (`RBID`) and firmographic attributes you can use for enrichment or targeting. The `keyword` field accepts natural language — describe the type of organization, not just a category name.

## Next steps

See the endpoint reference for `POST /v2/organization/resolve` and `POST /v2/organization/discover` in the sidebar for full parameter and response details.