Skip to main content

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.

Table of Contents

Data Sources

All entity data comes from the North Carolina Secretary of State, Business Registration Division (sosnc.gov). This is the official register for every domestic and foreign business entity in North Carolina, covering corporations, LLCs, partnerships, nonprofits, cooperatives, banks, insurance companies, and public authorities registered under the NC General Statutes. Every request fetches data live from the register. There is no cached or batch-synced alternative for North Carolina.
North Carolina is a single-source country. All data — company profile, officers, registered agent, documents, and search — comes from the NC Secretary of State Business Registration Division.

Company Identifiers

Query Identifiers

Identifier TypeFormatExampleNotes
SOS ID7-digit integer, zero-padded0012834Assigned by NC SOS at formation or qualification. Also called Entity ID.
The SOS ID is the only identifier supported for company retrieval. To find a SOS ID from a name, use the search endpoint first. Both zero-padded (0012834) and raw (12834) forms are accepted; values are always normalized to 7 digits.

Identifiers in API Response

IdentifierFormatExampleFound In
sosId7-digit, zero-padded0012834All entities

Search Capabilities

Search TypePatternExampleMatch TypeExpected Results
By NameFree-text string"Pinecrest Technologies"Any-wordMultiple results
By SOS ID7 digits (with or without leading zeros)0012834ExactSingle company
Name search uses any-word matching against the NC SOS register: results include entities that contain any of the words in the query. Searching by SOS ID returns a single result with matchReason.matchType = "id".

Quirks & Gotchas

QuirkDetails
No shareholder registerNC SOS does not collect or publish shareholder lists for any entity type.
No UBO registerNo public beneficial ownership register exists at the North Carolina state level.
No activity codesThe NC SOS does not collect NAICS, NACE, or ISIC industry codes.
No EIN / federal tax IDThe federal Employer Identification Number is not published through the NC SOS.
Non-profit officers not publicNonprofit Corporation (Chapter 55A) profiles do not include officers. legalRepresentatives is always empty for these entities.
Officer roles are free-textOfficer titles come from annual reports and are not validated for consistency. Common roles are mapped deterministically; rare or novel titles are standardized using AI enrichment.
Corporate registered agentsRegistered agent companies (e.g. CT Corporation System, Corporation Service Company) appear as plain text without a link on the profile page; individual registered agents have a linked profile. Both are returned correctly in otherKeyPersons.
Annual reports excluded from filingsThe filing list omits Annual Report filings. Only formation documents and other corporate acts (amendments, mergers, conversions, etc.) are included.
No Certificate of Existence in v1The $10 NC Certificate of Existence (equivalent to a Certificate of Good Standing) is not yet offered through Topograph.
No bulk open dataNC SOS does not publish a free open-data business register. All reads are live. Response times are typically 15–40 seconds.

Mappings

Company Status

Status is sourced directly from the NC SOS portal and mapped deterministically. No AI inference is involved.
NC SOS StatusActiveNotes
Current-ActiveYesStandard in-good-standing status
Current-Active AR ErrorYesActive but annual report has a processing error
Active/Not CurrentYesActive but annual report not yet filed for current year
Active/Failure to Pay FeeYesActive but fee outstanding
In ProcessYesFormation in progress
Admin. CancelledNoAdministratively cancelled by SOS
Applied to WithdrawNoForeign entity has applied to withdraw qualification
Auto DissolveNoAutomatically dissolved for non-compliance
ConsolidatedNoMerged into another entity (consolidation)
ConvertedNoEntity has converted to a different legal form
Court Ordered DissolutionNoJudicially dissolved
DissolvedNoVoluntarily or administratively dissolved
ExpiredNoRegistration term expired (certain entity types)
Failure to Pay FeeNoLapsed for non-payment
Judicial DissolutionNoDissolved by court order
MergedNoMerged into another entity
Non-domesticatedNoForeign entity that never completed qualification
Not RegisteredNoEntity not registered with NC SOS
PA SuspendedNoSuspended under professional association rules
Reserved NameNoName reservation only, no active entity
Revoked Licensing BoardNoRevoked by a professional licensing board
To Federal BankNoConverted to federal bank charter
To Foreign Insurance CoNoConverted to foreign insurance company
WithdrawnNoForeign entity has withdrawn its NC qualification
Withdrawn by MergerNoForeign entity withdrawn as part of a merger
NC SOS uses a closed list of 30 entity types from the Business Registration portal. Every type is mapped deterministically to a standardized category. No AI is involved.
NC SOS TypeEnglish NameStandardizedISO 20275
Limited Liability CompanyLimited Liability CompanyLimitedLiabilityCompany2HBR
Professional Limited Liability CompanyProfessional Limited Liability Company (PLLC)LimitedLiabilityCompany
L3CLow-profit Limited Liability Company (L3C)LimitedLiabilityCompany
NC SOS TypeEnglish NameStandardizedISO 20275
Business CorporationBusiness CorporationCorporationECSB
Professional CorporationProfessional Corporation (PC)Corporation
NC SOS TypeEnglish NameStandardizedISO 20275
Non-Profit CorporationNonprofit CorporationNonprofitOrganization
Non-Incorporated Non-ProfitUnincorporated Nonprofit AssociationNonprofitOrganization
Non-Profit Community TrustNon-Profit Community TrustNonprofitOrganization
NC SOS TypeEnglish NameStandardizedISO 20275
Limited Liability PartnershipLimited Liability PartnershipPartnershipLLP
Limited PartnershipsLimited PartnershipPartnershipLPNL
RLLLPRegistered Limited Liability Limited PartnershipPartnership
NC SOS TypeEnglish NameStandardizedISO 20275
Cooperative AssociationCooperative AssociationOther
Cooperative 54 16Cooperative (GS 54-16)Other
Electric Membership CooperativeElectric Membership CooperativeOther
Mutual AssociationMutual AssociationOther
NC SOS TypeEnglish NameStandardizedISO 20275
BankState-Chartered BankOtherBANK
National Banking AssociationNational Banking AssociationOther
Mutual Deposit Guaranty AssociationMutual Deposit Guaranty AssociationOther
Savings & Loan AssociationSavings & Loan AssociationOther
State Savings BankState Savings BankOther
NC SOS TypeEnglish NameStandardizedISO 20275
Insurance CompanyInsurance CompanyOther
Captive InsuranceCaptive Insurance CompanyOther
Dental Service CorporationDental Service CorporationCorporation
NC SOS TypeEnglish NameStandardizedISO 20275
MunicipalMunicipal EntityOther
Public Transportation AuthorityPublic Transportation AuthorityOther
RailroadRailroadOther
County Agricultural FairCounty Agricultural FairOther
NC SOS TypeEnglish NameStandardizedISO 20275
Mutual Burial AssociationMutual Burial AssociationOther
Non-Domestic TobaccoNon-Domestic Tobacco EntityOther
OtherOtherOther
Officers are sourced from the entity’s annual report filings. Common role titles are mapped deterministically to standardized roles. Titles not in the deterministic set are standardized using AI enrichment; the raw title is always preserved as localName.
NC SOS Role TitleStandardized Role
PresidentPresident
Vice PresidentVice President
Vice-PresidentVice President
Senior Vice PresidentVice President
Executive Vice PresidentVice President
First Vice PresidentVice President
Assistant Vice PresidentVice President
SecretarySecretary
Assistant SecretarySecretary
TreasurerTreasurer
Assistant TreasurerTreasurer
DirectorDirector
Executive DirectorExecutive Director
Non-Executive DirectorNon-Executive Director
Independent DirectorNon-Executive Director
CEOCEO
Chief Executive OfficerCEO
Executive OfficerCEO
CFOCFO
Chief Financial OfficerCFO
Chief Accounting OfficerCFO
Corporate ControllerCFO
ControllerCFO
COOCOO
Chief Operating OfficerCOO
Chief Administrative OfficerCOO
General CounselGeneral Counsel
Chief Legal OfficerGeneral Counsel
CLOGeneral Counsel
ChairmanChairman
ChairpersonChairman
ChairChairman
Vice ChairmanChairman
Chairman of the BoardChairman of the Board
Authorized RepresentativeAuthorized Signatory
Authorized SignerAuthorized Signatory
Authorized AgentAuthorized Signatory
ManagerManager
Managing MemberManaging Director
MemberOther
Managing PartnerManaging Partner
General PartnerGeneral Partner
Limited PartnerLimited Partner
PartnerPartner
Officer titles not in the deterministic set are standardized using AI enrichment. The raw title is always preserved in role.localName. Officers are available for Business Corporations, LLCs, and partnerships. Nonprofit Corporations (Chapter 55A) do not expose officers on the public profile page, so legalRepresentatives is always empty for these entities.

Other Key Persons

The registered agent is always returned as an Other Key Person, regardless of whether the agent is an individual or a corporate entity.
RoleStandardizedNotes
Registered AgentRegistered AgentStatutory service-of-process contact; required for all NC-registered entities. Can be an individual or a corporate registered agent company.

Data Availability

Data PointAvailableNotes
Legal nameYesCurrent legal name from the NC SOS profile
Previous namesYesHistorical names if the entity has been renamed
Company statusYesMapped from NC SOS status field (see status table above)
CitizenshipYesDomestic or Foreign
Registration dateYesDate of formation or qualification in NC
Legal addressYesPrincipal office address, geocoded
Mailing addressYesSeparate mailing address if different from principal office
Registered office addressYesNC registered office address
Legal formYesFrom NC SOS entity type (30 forms)
Share capitalYesAuthorized share classes with par value, for corporations
Legal representativesYes*Officers from annual reports. Always empty for Nonprofit Corporations.
Registered agentYesReturned as Other Key Person
Filing history (documents)YesFormation documents and other corporate acts — see Documents section
Activity codesNoNot collected by NC SOS
ShareholdersNoNot published by NC SOS for any entity type
UBOsNoNo public state-level UBO register
Federal tax ID (EIN)NoNot published by NC SOS
Financial dataNoNot collected

Documents

Available Documents

DocumentAPI CategoryAvailabilityFormatNotes
Trade Register ExtracttradeRegisterExtractAlways availablePDFPrinted PDF of the entity’s public profile page from NC SOS
Articles of Organization / IncorporationarticlesOfAssociation[]When filed and available in NC SOS imagingPDFFormation filing (Articles of Organization for LLCs, Articles of Incorporation for corporations)
Other NC SOS FilingsotherDocuments[]When filed and availablePDFAmendments, mergers, conversions, registered agent changes, and other corporate acts
Annual Report filings are excluded from the document list. The Trade Register Extract and all individual filing PDFs are included in the company-data block at no extra charge. The $10 NC Certificate of Existence is not yet available.
Formation documents that match “Articles of Organization”, “Articles of Incorporation”, “Articles of Association”, or “Certificate of Formation” are returned under articlesOfAssociation. All other filing types are returned under otherDocuments.

Example API Responses

All examples use placeholder data. Query with POST /v2/company.

Search by Name

curl -X POST "https://api.topograph.co/v2/search?country=US-NC&query=Pinecrest+Technologies" \
  -H "x-api-key: YOUR_API_KEY"
[
  {
    "id": "0012834",
    "legalName": "Pinecrest Technologies, LLC",
    "countryCode": "US-NC",
    "matchReason": { "matchType": "default" }
  }
]

Search by SOS ID

curl -X POST "https://api.topograph.co/v2/search?country=US-NC&query=0012834" \
  -H "x-api-key: YOUR_API_KEY"
[
  {
    "id": "0012834",
    "legalName": "Pinecrest Technologies, LLC",
    "countryCode": "US-NC",
    "matchReason": {
      "matchType": "id",
      "identifier": { "sosId": "0012834" }
    }
  }
]

Company Profile

curl -X POST "https://api.topograph.co/v2/company" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"countryCode": "US-NC", "id": "0012834", "dataPoints": ["company", "legalRepresentatives", "otherKeyPersons"]}'
{
  "company": {
    "id": "0012834",
    "countryCode": "US-NC",
    "identifiers": { "sosId": "0012834" },
    "legalName": "Pinecrest Technologies, LLC",
    "registrationDate": "2002-06-15",
    "status": {
      "localName": "Current-Active",
      "active": true
    },
    "legalForm": {
      "localName": "Limited Liability Company",
      "standardized": "LimitedLiabilityCompany"
    },
    "legalAddress": {
      "addressLine1": "4200 Six Forks Road",
      "city": "Raleigh",
      "state": "NC",
      "postalCode": "27609",
      "countryCode": "US"
    }
  },
  "legalRepresentatives": [
    {
      "type": "individual",
      "role": { "localName": "Manager", "standardized": "Manager" },
      "individual": { "name": { "fullName": "Jane R. Holloway" } }
    },
    {
      "type": "individual",
      "role": { "localName": "President", "standardized": "President" },
      "individual": { "name": { "fullName": "Thomas G. Kendrick" } }
    }
  ],
  "otherKeyPersons": [
    {
      "type": "individual",
      "role": { "localName": "Registered Agent", "standardized": "RegisteredAgent" },
      "individual": { "name": { "fullName": "Marcus L. Duvall" } }
    }
  ]
}
{
  "company": {
    "id": "0019205",
    "countryCode": "US-NC",
    "identifiers": { "sosId": "0019205" },
    "legalName": "Cape Fear Manufacturing Corporation",
    "registrationDate": "1991-03-22",
    "status": {
      "localName": "Current-Active",
      "active": true
    },
    "legalForm": {
      "localName": "Business Corporation",
      "standardized": "Corporation"
    },
    "capital": {
      "amount": 100000,
      "currency": "USD",
      "formatted": "10,000,000 Common (par USD 0.01)"
    },
    "legalAddress": {
      "addressLine1": "1 Commerce Street",
      "city": "Wilmington",
      "state": "NC",
      "postalCode": "28401",
      "countryCode": "US"
    }
  },
  "legalRepresentatives": [
    {
      "type": "individual",
      "role": { "localName": "President", "standardized": "President" },
      "individual": { "name": { "fullName": "Robert A. Whitfield" } }
    },
    {
      "type": "individual",
      "role": { "localName": "Secretary", "standardized": "Secretary" },
      "individual": { "name": { "fullName": "Helen F. Carmichael" } }
    },
    {
      "type": "individual",
      "role": { "localName": "Treasurer", "standardized": "Treasurer" },
      "individual": { "name": { "fullName": "David P. Sousa" } }
    }
  ],
  "otherKeyPersons": [
    {
      "type": "company",
      "role": { "localName": "Registered Agent", "standardized": "RegisteredAgent" },
      "company": {
        "legalName": "National Registered Agents, Inc.",
        "countryCode": "US-NC"
      }
    }
  ]
}
{
  "company": {
    "id": "0005417",
    "countryCode": "US-NC",
    "identifiers": { "sosId": "0005417" },
    "legalName": "Piedmont Community Foundation",
    "registrationDate": "1956-09-10",
    "status": {
      "localName": "Current-Active",
      "active": true
    },
    "legalForm": {
      "localName": "Non-Profit Corporation",
      "standardized": "NonprofitOrganization"
    },
    "legalAddress": {
      "addressLine1": "222 North Elm Street",
      "city": "Greensboro",
      "state": "NC",
      "postalCode": "27401",
      "countryCode": "US"
    }
  },
  "legalRepresentatives": [],
  "otherKeyPersons": [
    {
      "type": "individual",
      "role": { "localName": "Registered Agent", "standardized": "RegisteredAgent" },
      "individual": { "name": { "fullName": "Sandra K. Pryor" } }
    }
  ]
}
Note: Nonprofit Corporation profiles do not include officers on the NC SOS public profile page. legalRepresentatives is always empty for Chapter 55A entities.
{
  "company": {
    "id": "0021176",
    "countryCode": "US-NC",
    "identifiers": { "sosId": "0021176" },
    "legalName": "Coastal Ventures Group LLC",
    "registrationDate": "2008-11-03",
    "status": {
      "localName": "Current-Active",
      "active": true
    },
    "legalForm": {
      "localName": "Limited Liability Company",
      "standardized": "LimitedLiabilityCompany"
    },
    "legalAddress": {
      "addressLine1": "800 Battery Park Avenue",
      "city": "Asheville",
      "state": "NC",
      "postalCode": "28801",
      "countryCode": "US"
    }
  },
  "legalRepresentatives": [
    {
      "type": "individual",
      "role": { "localName": "Manager", "standardized": "Manager" },
      "individual": { "name": { "fullName": "Victor E. Larson" } }
    }
  ],
  "otherKeyPersons": [
    {
      "type": "individual",
      "role": { "localName": "Registered Agent", "standardized": "RegisteredAgent" },
      "individual": { "name": { "fullName": "Patricia W. Nguyen" } }
    }
  ]
}
{
  "company": {
    "id": "0007893",
    "countryCode": "US-NC",
    "identifiers": { "sosId": "0007893" },
    "legalName": "Old Dominion Textiles, Inc.",
    "registrationDate": "1975-04-01",
    "status": {
      "localName": "Dissolved",
      "active": false
    },
    "legalForm": {
      "localName": "Business Corporation",
      "standardized": "Corporation"
    },
    "legalAddress": {
      "addressLine1": "300 Industrial Drive",
      "city": "Burlington",
      "state": "NC",
      "postalCode": "27215",
      "countryCode": "US"
    }
  },
  "legalRepresentatives": [],
  "otherKeyPersons": []
}
curl -X POST "https://api.topograph.co/v2/company" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"countryCode": "US-NC", "id": "0012834", "dataPoints": ["availableDocuments"]}'
{
  "documents": {
    "tradeRegisterExtract": {
      "id": "doc_tre_abc123",
      "name": "Trade Register Extract",
      "format": "pdf"
    },
    "articlesOfAssociation": [
      {
        "id": "doc_aoa_def456",
        "name": "Articles of Organization",
        "format": "pdf",
        "date": "2002-06-15",
        "description": "NC SOS filing: Articles of Organization, filed 06/15/2002"
      }
    ],
    "otherDocuments": [
      {
        "id": "doc_other_ghi789",
        "name": "Articles of Amendment",
        "format": "pdf",
        "date": "2015-03-10",
        "description": "NC SOS filing: Articles of Amendment, filed 03/10/2015"
      }
    ]
  }
}