Tools (5)

search_company
get_company_details
list_officers
check_company_status
report_feedback

search_company

Search the global company registry by name.

Covers 200+ jurisdictions via the OpenCorporates database.

Args:
name: Company name or partial name to search for (e.g. "Apple", "Acme Corp").
jurisdiction: OpenCorporates jurisdiction code (e.g. "gb" for UK, "us_de" for Delaware,
"no" for Norway, "de" for Germany). Omit for global search.
status: Filter by company status: "Active", "Dissolved", "Inactive". Omit for all.
max_results: Number of results to return (1–100, default 20).

Returns:
Dictionary with count and list of matching companies (registry_id, name, jurisdiction,
status, incorporation_date, company_type, address). Use registry_id for details.

Parameter	Type	Required	Description
`name`	`string`	required	Company name or partial name to search for (e.g. "Apple", "Acme Corp").
`jurisdiction`	`any`	optional	OpenCorporates jurisdiction code (e.g. "gb" for UK, "us_de" for Delaware, "no" for Norway, "de" for Germany). Omit for global search.
`status`	`any`	optional	Filter by company status: "Active", "Dissolved", "Inactive". Omit for all.
`max_results`	`integer`	optional	Number of results to return (1–100, default 20). (default: 20)

Request Body

{
  "name": "example"
}

get_company_details

Get full details for a specific company.

Returns comprehensive information including registered address, industry codes,
incorporation and dissolution dates, and company type.

Args:
registry_id: Company identifier in the format "{jurisdiction}/{company_number}",
e.g. "gb/12345678" or "us_de/1234567". Obtained from search_company.

Returns:
Full company record, or {"error": "not_found"} if the registry ID is unknown.

Parameter	Type	Required	Description
`registry_id`	`string`	required	Company identifier in the format "{jurisdiction}/{company_number}", e.g. "gb/12345678" or "us_de/1234567". Obtained from search_company.

Request Body

{
  "registry_id": "123456789"
}

list_officers

List directors and officers of a company.

Returns all registered officers including directors, secretaries, and other
roles where this information is publicly available.

Args:
registry_id: Company identifier in the format "{jurisdiction}/{company_number}",
e.g. "gb/12345678". Obtained from search_company.

Returns:
Dictionary with count and list of officers (name, role, start_date, end_date,
nationality, occupation, inactive flag).

Parameter	Type	Required	Description
`registry_id`	`string`	required	Company identifier in the format "{jurisdiction}/{company_number}", e.g. "gb/12345678". Obtained from search_company.

Request Body

{
  "registry_id": "123456789"
}

check_company_status

Quick status check for a company by name.

Returns the top matching company and its current status (active, dissolved, etc.).
Useful for KYC pre-checks and supplier verification.

Args:
name: Company name to check (exact or near-exact match works best).
jurisdiction: OpenCorporates jurisdiction code (e.g. "gb", "us_de", "no").
Strongly recommended to reduce ambiguity.

Returns:
Object with the best match company name, status, registry_id, and jurisdiction.
Returns {"error": "not_found"} if no matches are found.

Parameter	Type	Required	Description
`name`	`string`	required	Company name to check (exact or near-exact match works best).
`jurisdiction`	`any`	optional	OpenCorporates jurisdiction code (e.g. "gb", "us_de", "no"). Strongly recommended to reduce ambiguity.

Request Body

{
  "name": "example"
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

Request Body

{
  "feedback": "example"
}

Quick Start

Shell

curl -X POST "https://context.gnist.ai/rest/opencorporates/search_company" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"name": "example"}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/rest/opencorporates/search_company",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={
  "name": "example"
},
)
print(resp.json())