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

# Canada (Nova Scotia)

> Identifiers, data sources, and integration details for companies registered in Nova Scotia

## Start here

This guide contains public integration notes for `CA-NS`, the Nova Scotia register. Use it for identifier formats, search behavior, and register-specific caveats. The live source of truth for coverage, pricing, data sources, legal forms, roles, and status values is the pricing page.

<Card title="Canada (Nova Scotia) coverage, pricing, and sources" icon="arrow-up-right-from-square" href="https://topograph.co/pricing/ca-ns">
  Open the current catalog for supported datapoints, sources, identifiers, and availability.
</Card>

<Warning>
  Canada (Nova Scotia) is in beta. Check the live pricing page or contact support before relying on it in production.
</Warning>

<Info>
  **`CA-NS` covers entities registered in Nova Scotia.** In Canada a company is incorporated either federally or in one province or territory, and each keeps its own register. A federal corporation that registers in Nova Scotia to do business there keeps its own record in [Canada (Federal)](/essentials/canada-federal): its Nova Scotia registration is returned here flagged as such (a branch registration, with its home jurisdiction), never as a Nova Scotia incorporation. `CA` on its own is not a jurisdiction.
</Info>

## Table of Contents

* [Data Sources](#data-sources)
* [Company Identifiers](#company-identifiers)
* [Search Capabilities](#search-capabilities)
* [Supported Entity Types](#supported-entity-types)
* [Quirks & Gotchas](#quirks--gotchas)
* [Data Availability](#data-availability)

## Data Sources

| Source | Role | What it provides |
| - | - | - |
| Registry of Joint Stock Companies (RJSC Connect) | **Primary source** for search, company data and legal representatives | Registered name, former and trade names, entity type, status and its date, registration date, registered office, directors, officers with the office held, partners |
| Canada's Business Registries | Supplementary | Business Number of Nova Scotia records |
| GLEIF | Supplementary | Legal Entity Identifier (LEI), when one matches the registry ID |

Search, company data and legal representatives are read live from the public record of the Registry of Joint Stock Companies, so every request reflects the register as it stands. One read serves both datapoints. A read takes up to a minute, so company data is available in `verification` mode only, not in `onboarding` mode.

## Company Identifiers

### Query Identifiers

| Identifier Type | Format | Example | Notes |
| - | - | - | - |
| **Registry ID** | 7 digits | `3023784` | Assigned by the Registry of Joint Stock Companies ("Reg. Number"). Spaces are ignored. |

### Identifiers in API Response

| Identifier | Format | Example | Found In |
| - | - | - | - |
| `registryId` | 7 digits | `3023784` | All entities. Same value as `company.id` |
| `businessNumber` | 9 digits (the BN root) | `104902135` | When the register publishes it on Canada's Business Registries |
| `lei` | 20 letters and digits | | When GLEIF has a unique match |

## Search Capabilities

| Search Type | Example | Match Type | Notes |
| - | - | - | - |
| By name | `Sobeys` | Name | Every entity whose name contains the words, at most 50 results, exact matches and active entities first |
| By registry ID | `3023784` | `id` | Exact match |

<Tip>
  Search is free. Only company data retrieval is charged.
</Tip>

### Active companies only

Search returns inactive entities too (struck off, revoked, amalgamated, dissolved). Each result carries the register's status, so [`activeOnly=true`](/essentials/search#active-companies-only) removes the closed ones. A registration revoked less than a year ago can still be reinstated and is kept.

## Supported Entity Types

| Entity type | Supported | Notes |
| - | - | - |
| Limited companies, unlimited companies (ULC), private investment holding companies | Yes | Company data, directors and officers |
| Co-operatives, societies | Yes | Company data, directors and officers |
| Partnerships, limited partnerships, sole proprietorships | Yes | Company data; partners (people or corporations) |
| Nova Scotia registrations of federal, other-province or foreign corporations | Flagged | Returned as an extra-provincial registration with its home jurisdiction; directors and officers as filed in Nova Scotia |
| Business names and name reservations | No | Trade names and reservations are not entities; a company's active business names are returned as its trade names |

## Quirks & Gotchas

| Quirk | Details |
| - | - |
| **Extra-provincial registrations** | A corporation incorporated federally or in another province also has a Nova Scotia registry ID. Its legal form is the extra-provincial type (`Extra-provincial Corporation Federal`, standardized as `Corporation`), it carries no incorporation date, and `status.statusDetails.additionalInfo` names its home jurisdiction (`CA-FED` for a federal corporation). |
| **Officers and their offices** | Officers hold one of the register's offices (President, Vice-president, Secretary, Treasurer) or an office in the filer's own words, returned as typed (`EXECUTIVE VICE PRESIDENT & CHIEF FINANCIAL OFFICER`) with the standardized role read from the title. A person with two offices appears once per office. |
| **No addresses for people** | The register publishes no address for directors and officers. |
| **The recognized agent is not returned** | The person or firm that accepts service in Nova Scotia is not a legal representative. |
| **No shareholders, no beneficial owners** | The register publishes neither. Nova Scotia companies keep their register of individuals with significant control themselves. |
| **No activity codes** | The register records no industry classification. |

## Data Availability

| Datapoint | Available | Notes |
| - | - | - |
| `company` | Yes | Live from the register |
| `legalRepresentatives` | Yes | Directors, officers and partners, live from the register |
| `shareholders` | No | Not published |
| `ultimateBeneficialOwners` | No | Not public |
| Documents | Not yet | Filed documents and profile reports are sold by the register |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.