> ## 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.
# New Jersey
> Country-specific identifiers, data sources, and integration details
## Start here
This guide contains public integration notes for New Jersey. Use it for identifier formats, search behavior, and country-specific caveats. The live source of truth for coverage, pricing, data sources, documents, legal forms, roles, and status values is the pricing page.
Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
This jurisdiction may be in preview or limited availability. Check the live pricing page or contact support before relying on it in production.
Country details below are preserved as integration notes. If a table or example conflicts with the live pricing page, use the pricing page as the source of truth and contact support.
## Table of Contents
* [Data Sources](#data-sources)
* [Company Identifiers](#company-identifiers)
* [Search Capabilities](#search-capabilities)
* [Quirks & Gotchas](#quirks--gotchas)
* [Mappings](#mappings)
* [Legal Forms](#legal-forms)
* [Data Availability](#data-availability)
**API access:** `US-NJ` is not yet part of the public `countryCode` enum. Contact us to enable it on your workspace. Requests sent with `countryCode: "US-NJ"` will otherwise return `400` until the enum is expanded.
## Data Sources
New Jersey uses a single integration against the **New Jersey Division of Revenue and Enterprise Services (DORES)**, within the New Jersey Department of the Treasury. The register covers every domestic and foreign corporation, limited liability company, limited partnership, and non-profit registered in New Jersey.
Two tiers of data are available:
* **Free public Business Name Search** (onboarding mode). DORES publishes a free, publicly accessible Business Name Search portal that returns five fields per entity: business name, 10-digit entity ID, home city, entity type, and incorporation date. This is used for fast onboarding checks and company search. No officers, members, addresses, or status are included at this tier.
* **Paid Business Entity Status Report** (verification mode). A per-entity report purchased from the DORES Business Records Service. This is the authoritative source for current entity status, registered agent, principal business address, officers and directors with roles and residence addresses, stock amount and class, all filings with dates, and any Department of Revenue or Tax suspensions. The report is retrieved live from the register for each request.
New Jersey publishes no open bulk data. There is no state business-entity dataset on the New Jersey Open Data portal. The free DORES public search is the only no-cost path to company data.
**Filing lag.** Filings, amendments, and annual reports submitted to DORES may take up to two business days to appear in the public portal and status report. Very recently filed or amended entities may not yet be discoverable.
## Company Identifiers
### Query Identifiers
| Identifier Type | Format | Example | Notes |
| ---------------- | ------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------ |
| **NJ Entity ID** | 10 digits, numeric, leading zeros preserved | `0100307257` | Primary identifier assigned by DORES. Used to look up filings on the portal and to purchase paid business records. |
The NJ Entity ID is always exactly 10 digits with leading zeros. Submitting an unpadded form (e.g. `100307257` instead of `0100307257`) will be rejected. The leading digits loosely reflect registration vintage (e.g. `01` for pre-2000 corporations, `04` for LLCs from the 2000s) but do not encode entity type.
### Identifiers in API Response
| Identifier | Format | Example | Found In |
| ---------- | ------------------------------------------- | ------------ | ------------ |
| `entityId` | 10 digits, numeric, leading zeros preserved | `0100307257` | All entities |
## Search Capabilities
| Search Type | Pattern | Example | Match Type | Expected Results |
| --------------- | ----------- | -------------- | ------------------------------ | ---------------------------------------------------------------------- |
| By Name | 2-100 chars | `"Prudential"` | Starts-with (case-insensitive) | Multiple results |
| By NJ Entity ID | 10 digits | `0100307257` | Exact | Exact match returned first (`matchType: id`); other results may follow |
**Starts-with search.** Name search anchors on the beginning of the legal name (case-insensitive). Use fuller query strings to narrow the result set, which is capped at 50 matches.
## Quirks & Gotchas
| Quirk | Details |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Leading zeros are load-bearing** | Entity IDs are always exactly 10 digits with leading zeros. Never strip them: the register and our API treat `0100307257` and `100307257` as different keys. |
| **Free tier returns no status** | The DORES public search returns name, ID, city, entity type, and incorporation date only. Current status (active, suspended, dissolved, revoked) is only available through the paid Business Entity Status Report. |
| **Free tier returns no officers** | Officers, LLC members, and managers are not disclosed in the free public search. They are only included when the customer opts into verification mode, which purchases a per-entity Business Entity Status Report. |
| **No shareholder or UBO register** | New Jersey does not publish shareholders or beneficial owners for any entity type. |
| **No open bulk data** | There is no business-entity open-data export from DORES. Bulk access requires a paid commercial feed agreement with the register directly. |
| **No activity codes** | NAICS, NACE, or ISIC codes are not collected by the state business register. |
| **DBA names are not in the state register** | Doing-business-as names (fictitious names) are filed at the county clerk level in New Jersey and are not part of the state register dataset. |
| **2-business-day filing lag** | Newly filed or amended records may take up to two business days to appear in the portal and status report. |
| **Status Report is the only document available** | Standing certificates and certified copies of charter documents are not yet available through Topograph. These are delivered per request by the register. |
## Mappings
### Legal Forms
Legal form is derived from the entity-type abbreviations surfaced by the DORES public Business Name Search. The abbreviation is the canonical value published by the register; NJ does not publish a numeric legal-form code. Eleven distinct abbreviations were observed across broad samples.
| DORES Abbreviation | Local Name | Standardized |
| ------------------ | -------------------------------------- | ----------------------- |
| `DP` | Domestic Profit Corporation | Corporation |
| `FR` | Foreign For-Profit Corporation | Corporation |
| `DB` | Foreign Corporation (legacy) | Corporation |
| `PA` | Professional Corporation | Corporation |
| `LLC` | Domestic Limited Liability Company | LimitedLiabilityCompany |
| `FLC` | Foreign Limited Liability Company | LimitedLiabilityCompany |
| `NP` | Domestic Non-Profit Corporation | NonprofitOrganization |
| `NF` | Foreign Non-Profit Corporation | NonprofitOrganization |
| `LP` | Limited Partnership | Partnership |
| `LF` | Foreign Limited Partnership | Partnership |
| `LLP` | Domestic Limited Liability Partnership | Partnership |
ISO 20275 ELF codes are not mapped for New Jersey. GLEIF ELF coverage for US sub-national entity types is incomplete, so no ELF codes are assigned. See the pricing page for the full legal forms table.
## Data Availability
| Data Point | Available | Notes |
| ---------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| Company name | Yes | Current legal name |
| Company status | Verification only | Included in the paid Business Entity Status Report. Not available in onboarding mode. |
| Registration date | Yes | DORES initial incorporation date |
| Legal address | Verification only | Principal business address from the paid Business Entity Status Report. Home city only in onboarding mode. |
| Legal form | Yes | 11-value DORES abbreviation vocabulary with standardized mapping |
| Legal representatives | Verification only | Officers, directors, members, and managers from the paid Business Entity Status Report. Not disclosed in onboarding mode. |
| Registered agent | Verification only | From the paid Business Entity Status Report. Not in the free search. |
| Activity codes | No | Not collected by the state business register |
| Shareholders | No | Not published |
| UBOs | No | Not published (no state-level beneficial ownership register) |
| Documents | Partial | Business Entity Status Report available in verification mode. Standing certificates and certified copies are not yet available through Topograph. |
| Financial data | No | Not collected |
| DBA / fictitious names | No | Filed at county clerk level, not in the state register |
## Example API Responses
### Search by Name
```bash theme={null}
curl -X POST "https://api.topograph.co/v2/search?country=US-NJ&query=Acme" \
-H "x-api-key: YOUR_API_KEY"
```
```json theme={null}
[
{
"id": "0400123456",
"legalName": "ACME HOLDINGS LLC",
"countryCode": "US-NJ",
"matchReason": {
"matchType": "default"
},
"address": {
"city": "Newark",
"region": "NJ",
"countryCode": "US"
}
}
]
```
### Search by Entity ID
```bash theme={null}
curl -X POST "https://api.topograph.co/v2/search?country=US-NJ&query=0400123456" \
-H "x-api-key: YOUR_API_KEY"
```
```json theme={null}
[
{
"id": "0400123456",
"legalName": "ACME HOLDINGS LLC",
"countryCode": "US-NJ",
"matchReason": {
"matchType": "id"
}
}
]
```
### Company Profile (Onboarding Mode)
```bash theme={null}
curl -X POST "https://api.topograph.co/v2/company" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"countryCode": "US-NJ", "id": "0400123456", "dataPoints": ["company"], "mode": "onboarding"}'
```
```json theme={null}
{
"company": {
"id": "0400123456",
"countryCode": "US-NJ",
"identifiers": { "entityId": "0400123456" },
"legalName": "ACME HOLDINGS LLC",
"registrationDate": "2005-03-14",
"legalForm": {
"localName": "Domestic Limited Liability Company",
"standardized": "LimitedLiabilityCompany"
},
"legalAddress": {
"city": "Newark",
"region": "NJ",
"countryCode": "US"
}
},
"legalRepresentatives": []
}
```
### Company Profile (Verification Mode)
```bash theme={null}
curl -X POST "https://api.topograph.co/v2/company" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"countryCode": "US-NJ", "id": "0400123456", "dataPoints": ["company", "legalRepresentatives"], "mode": "verification"}'
```
```json theme={null}
{
"company": {
"id": "0400123456",
"countryCode": "US-NJ",
"identifiers": { "entityId": "0400123456" },
"legalName": "ACME HOLDINGS LLC",
"status": "active",
"registrationDate": "2005-03-14",
"legalForm": {
"localName": "Domestic Limited Liability Company",
"standardized": "LimitedLiabilityCompany"
},
"legalAddress": {
"streetAddress": "100 Main Street",
"city": "Newark",
"region": "NJ",
"postalCode": "07102",
"countryCode": "US"
}
},
"legalRepresentatives": [
{
"role": "Member",
"firstName": "Jane",
"lastName": "Sample",
"address": {
"city": "Princeton",
"region": "NJ",
"countryCode": "US"
}
}
]
}
```
Verification mode purchases a Business Entity Status Report from the DORES Business Records Service on a per-entity basis. This is a paid upgrade. See the pricing page for current pricing.