> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getcurrent.ca/llms.txt
> Use this file to discover all available pages before exploring further.

# Business reports

> Fetch comprehensive business reports from Canadian registries

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

1. Run a [search](/guides/searching) to find the business and get its jurisdiction and registration number
2. Submit a report request with those details
3. The API fetches a comprehensive report from the registry
4. The report is stored and can be downloaded as a PDF

<Note>
  Reports typically take **1-4 minutes** to fetch. The registry lookup is the bottleneck.
</Note>

## Request

```bash theme={null}
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.

```json theme={null}
{
  "meta": {
    "searchId": "550e8400-e29b-41d4-a716-446655440000",
    "searchedAt": "2026-02-21T12:00:00.000Z",
    "searchedBy": "you@example.com",
    "name": "Example Corp",
    "jurisdiction": "ON",
    "registrationNumber": "1234567",
    "status": "completed",
    "duration": 148500
  },
  "report": {
    "legalName": { "name": "Example Corp", "matchScore": 1 },
    "registrationNumbers": [{ "label": "Ontario Corporation Number", "value": "1234567" }],
    "jurisdiction": "Ontario",
    "status": "Active",
    "addresses": [ ... ],
    "people": [ ... ],
    "details": {
      "goodStanding": true,
      "nameHistory": [ ... ],
      "naicsClassification": [ ... ]
    },
    "reportUrl": "https://...",
    "reportUrlExpiresAt": "2031-02-21T12:00:00.000Z"
  }
}
```

### Report fields

| Field                                | Description                                                |
| ------------------------------------ | ---------------------------------------------------------- |
| `report.details.goodStanding`        | Whether the business is in good standing (boolean or null) |
| `report.people`                      | Directors, officers, and shareholders with addresses       |
| `report.details.nameHistory`         | Previous legal names (array)                               |
| `report.details.naicsClassification` | Industry classifications (array)                           |
| `report.reportUrl`                   | Signed URL to download the report PDF (see below)          |
| `report.reportUrlExpiresAt`          | Expiry timestamp of `reportUrl`                            |

## Downloading the PDF

After a report is complete, you can download it as a PDF:

```bash theme={null}
curl -L "https://api.getcurrent.ca/v1/business-reports/document?searchId=UUID&registrationNumber=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

```python theme={null}
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']['details'].get('goodStanding')}")
```