Business reports provide detailed information about a specific Canadian business, including directors, officers, shareholders, addresses, good standing status, and more. Reports are fetched directly from the provincial or federal registry.
How it works
- Run a search to find the business and get its jurisdiction and registration number
- Submit a report request with those details
- The API fetches a comprehensive report from the registry
- The report is stored and can be downloaded as a PDF
Reports typically take 20-40 seconds to fetch. The registry lookup is the bottleneck.
Request
curl -X POST https://api.getcurrent.ca/v1/business-reports \
-H "Authorization: Bearer cur_live_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"jurisdiction": "ON",
"registrationNumber": "1234567",
"name": "Example Corp"
}'
Parameters
| Field | Type | Required | Description |
|---|
jurisdiction | string | Yes | Canadian jurisdiction code or full name (e.g. “ON”, “Ontario”, “Federal”) |
registrationNumber | string | Yes | Registration number from a search result |
name | string | Yes | Full legal name of the business |
searchId | string | No | UUID of a previous /search result to link this report to your search history |
Jurisdictions
Accepts codes or full names: AB, BC, MB, NB, NL, NS, NT, NU, ON, PE, QC, SK, YT, FED
Response
The response includes the report data with people, addresses, and business details.
{
"meta": {
"searchId": "550e8400-e29b-41d4-a716-446655440000",
"status": "completed",
"duration": 28500
},
"report": {
"legalName": "Example Corp",
"registrationNumber": "1234567",
"jurisdiction": "Ontario",
"status": "Active",
"goodStanding": true,
"craNumber": "123456789",
"addresses": [ ... ],
"people": [ ... ],
"nameHistory": [ ... ],
"naicsClassification": { ... },
"reportUrl": "https://..."
}
}
Report fields
| Field | Description |
|---|
goodStanding | Whether the business is in good standing (boolean or null) |
craNumber | CRA business number if available |
people | Directors, officers, and shareholders with addresses |
nameHistory | Previous legal names |
naicsClassification | Industry classification if available |
reportUrl | URL to the original registry report |
Downloading the PDF
After a report is complete, you can download it as a PDF:
curl -L "https://api.getcurrent.ca/v1/business-reports/document?searchId=UUID®istrationNumber=1234567" \
-H "Authorization: Bearer cur_live_xxxxxxxxxxxx" \
-o report.pdf
This returns a 302 redirect to a signed URL for the PDF document. Use -L (follow redirects) with cURL.
| Parameter | Required | Description |
|---|
searchId | Yes | Search ID from the report |
registrationNumber | Yes | Registration number |
businessName | No | Business name (for lookup) |
Typical workflow
import requests
import time
API_KEY = "cur_live_xxxxxxxxxxxx"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# 1. Search for the business
search = requests.post(
"https://api.getcurrent.ca/v1/search",
headers=HEADERS,
json={"name": "Example Corp"},
).json()
# 2. Get jurisdiction and registration number from results
biz = search["businesses"][0]
search_id = search["meta"]["searchId"]
# 3. Fetch the full report
report = requests.post(
"https://api.getcurrent.ca/v1/business-reports",
headers=HEADERS,
json={
"jurisdiction": biz["jurisdiction"],
"registrationNumber": biz["registrationNumbers"][0]["value"],
"name": biz["legalName"]["name"],
"searchId": search_id,
},
).json()
print(f"Status: {report['meta']['status']}")
print(f"Good standing: {report['report'].get('goodStanding')}")