Match and discover organizations

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.

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.

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.

Quickstart

Email Verification

Utility Endpoints

Match and discover organizations

Choose the right endpoint

Resolve an organization name

Search organizations by keyword

Next steps

​Choose the right endpoint

​Resolve an organization name

​Search organizations by keyword

​Next steps

Choose the right endpoint

Resolve an organization name

Search organizations by keyword

Next steps