Search Officers
search_officersSearch company officers and directors by name. Returns officer name, position, company, start/end dates, and nationality. REQUIRES your own OpenCorporates API token via _apiKey, their public API is closed and keyless calls return 401. Example: search_officers({query:"Elon Musk", _apiKey:"..."})
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "Elon Musk"
},
"name": "search_officers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Officer name to search (e.g., "John Smith") | |
| _apiKey | No | Your OpenCorporates API token (required, get one at https://opencorporates.com/api_accounts/new) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The search query used | |
| total | Yes | Total number of matching officers | |
| officers | Yes | List of matching officers | |
| returned | Yes | Number of officers returned in this response |