curl --request POST \
--url https://api.getcurrent.ca/v1/verify \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"legalName": "Shopify Inc.",
"jurisdiction": "ON",
"registrationNumber": "2033076"
}
'{
"meta": {
"verificationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"verifiedAt": "2026-02-21T12:00:00.000Z",
"duration": 23400,
"submitted": {
"legalName": "Shopify Inc.",
"jurisdiction": "ON",
"registrationNumber": "2033076",
"address": null
}
},
"results": {
"status": "verified",
"fields": {
"legalName": {
"status": "matched",
"score": 1,
"provided": "Shopify Inc.",
"registry": "SHOPIFY INC."
},
"registrationNumber": {
"status": "matched",
"score": 1,
"provided": "2033076",
"registry": "2033076"
},
"address": null
},
"analystSummary": "Verification passed for Shopify Inc. (ON-2033076). The legal name and registration number matched the Canadian business registry exactly. The business is currently active and in good standing. No further action is required."
},
"registryData": {
"legalName": "SHOPIFY INC.",
"registrationNumber": "2033076",
"jurisdiction": "Ontario",
"status": "Active",
"goodStanding": true,
"addresses": [
{
"street": "150 Elgin Street",
"city": "Ottawa",
"province": "Ontario",
"postalCode": "K2P 1L4",
"country": "Canada",
"raw": null
}
],
"people": [
{
"name": "Tobias Lutke",
"titles": [
"Director"
],
"addresses": []
}
],
"reportUrl": "https://storage.getcurrent.ca/.../report.pdf?signature=...",
"reportUrlExpiresAt": "2031-02-21T12:00:30.000Z"
}
}Verify Business
Verify customer-provided business data against Canadian business registry records.
Fetches fresh registry data, performs field-level matching with configurable thresholds, and returns structured results with an AI-generated analyst summary.
What gets verified:
- Legal name — normalized comparison (strips corporate suffixes like Inc., Corp., Ltd.)
- Registration number — normalized similarity match with configurable threshold (strips formatting and jurisdiction prefixes)
- Address — per-field fuzzy matching (optional)
- People — name and role matching against registry directors/officers (enabled by default)
Matching thresholds are governed by your account’s verification settings; a per-request
matching object overrides them. Out of the box (no custom settings), legal name, address, and
people default to 0.95 (fuzzy) and registration number to 1.0 (exact). A threshold of 1.0
requires an exact (normalized) match; lower values allow proportionally fuzzier matches.
Synchronous vs asynchronous: when a fresh registry lookup is required this endpoint
responds with 202 Accepted and a reportFetchId — poll
GET /verify/{id} until it returns the completed VerifyResponse. When a recent cached
registry report is available the result is returned synchronously with 200 OK.
Always branch on the HTTP status (or the presence of pending: true) rather than assuming 200.
Verification report PDF: set includeVerificationReport: true to get the verification
report PDF with the result (verificationReport.url), alongside the registry report PDF
(registryData.reportUrl), with no separate POST /generate-pdf call.
Typical response time: 20-40 seconds (registry lookup is the bottleneck)
curl --request POST \
--url https://api.getcurrent.ca/v1/verify \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"legalName": "Shopify Inc.",
"jurisdiction": "ON",
"registrationNumber": "2033076"
}
'{
"meta": {
"verificationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"verifiedAt": "2026-02-21T12:00:00.000Z",
"duration": 23400,
"submitted": {
"legalName": "Shopify Inc.",
"jurisdiction": "ON",
"registrationNumber": "2033076",
"address": null
}
},
"results": {
"status": "verified",
"fields": {
"legalName": {
"status": "matched",
"score": 1,
"provided": "Shopify Inc.",
"registry": "SHOPIFY INC."
},
"registrationNumber": {
"status": "matched",
"score": 1,
"provided": "2033076",
"registry": "2033076"
},
"address": null
},
"analystSummary": "Verification passed for Shopify Inc. (ON-2033076). The legal name and registration number matched the Canadian business registry exactly. The business is currently active and in good standing. No further action is required."
},
"registryData": {
"legalName": "SHOPIFY INC.",
"registrationNumber": "2033076",
"jurisdiction": "Ontario",
"status": "Active",
"goodStanding": true,
"addresses": [
{
"street": "150 Elgin Street",
"city": "Ottawa",
"province": "Ontario",
"postalCode": "K2P 1L4",
"country": "Canada",
"raw": null
}
],
"people": [
{
"name": "Tobias Lutke",
"titles": [
"Director"
],
"addresses": []
}
],
"reportUrl": "https://storage.getcurrent.ca/.../report.pdf?signature=...",
"reportUrlExpiresAt": "2031-02-21T12:00:30.000Z"
}
}Authorizations
Body
- Option 1
- Option 2
- Option 3
Supply the identity fields directly, or reference one of your stored business records by businessId (our id) or businessExternalId (your own id on the record) — its legal name, jurisdiction, registration number (and address / people) are hydrated from that record. Any field you also supply in the request overrides the record for this verification only; the stored record is never modified.
Verify one of your existing business records. When provided, legalName / jurisdiction / registrationNumber (and address / people) become optional and are taken from the record. Must reference a business owned by your tenant, otherwise the request fails with 404 NOT_FOUND. If the record is missing a required identity field the request fails with 400.
Reference a stored business record by your own id on it (its external_id) instead of businessId — same behavior. Unknown id → 404 NOT_FOUND (never creates a business). If both businessId and businessExternalId are supplied they must point at the same record, otherwise 400. (Distinct from externalId, which is result metadata, not a lookup.)
Your own reference id for this verification (e.g. a CRM record id). Recorded as metadata on the verification RESULT so you can find verifications by your own identifiers. This is NOT a business lookup and never modifies the business record — to reference a stored business by your own id, use businessExternalId.
"ref_1Nxxx"
Set true to receive the verification report PDF with the result, as verificationReport, next to the registry report PDF (registryData.reportUrl). The PDF is generated as the verification completes, so there is no separate POST /generate-pdf call to make. Adds a few seconds to a synchronous (200) response.
Response
Verification completed (check status field — may be verified or not_verified)
Was this page helpful?