1. Get an API key
Go to API Keys and generate a key. It will look like cur_live_xxxxxxxxxxxx.
2. Run a search
curl -X POST https://api.getcurrent.ca/v1/search \
-H "Authorization: Bearer cur_live_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"name": "Shopify Inc"}'
Searches typically take 20–40 seconds to complete. The business registry lookup is the bottleneck.
3. Read the response
A successful response returns a JSON object with several top-level sections:
{
"meta": {
"searchId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"name": "Shopify Inc",
"status": "completed",
"duration": 24318
},
"businesses": [
{
"legalName": { "name": "Shopify Inc.", "matchScore": 0.98 },
"jurisdiction": "Federal",
"status": "Active",
"incorporationDate": "2011-09-14",
"registrationNumbers": [
{ "label": "Federal Corporation Number", "value": "796223-2" }
]
}
],
"regulatory": {
"charities": [],
"msb": [],
"agcoCannabis": [],
"healthCanadaCannabis": []
},
"people": {
"directors": [],
"owners": [],
"officers": [],
"other": []
}
}
| Field | Description |
|---|
meta.searchId | Save this to retrieve the result later via GET /search/{id} |
meta.status | completed, completed-with-errors, or error |
businesses | Registry matches, sorted by confidence score |
regulatory | Charity, MSB, and cannabis registrations |
people | Directors, owners, and officers (deduplicated across sources) |
Next steps
