> ## 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.
# Rhode Island (US)
> State-specific identifiers, data sources, and integration details
This guide is outdated and will be removed on 1 November 2026. The up-to-date Rhode Island (US) reference is on the [Rhode Island (US) country page](https://www.topograph.co/countries/us-ri).
## Start here
This guide contains public integration notes for Rhode Island. Use it for identifier formats, search behavior, and state-specific caveats. The live source of truth for coverage, pricing, data sources, documents, legal forms, and status values is the pricing page.
Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
This jurisdiction is in preview. Check the live pricing page or contact support before relying on it in production.
State 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)
* [Entity Types](#entity-types)
* [Status Values](#status-values)
* [Officer Roles](#officer-roles)
* [Data Availability](#data-availability)
## Data Sources
Rhode Island uses a single integration against the **Rhode Island Department of State, Business Services Corporate Database**. The register covers domestic and foreign for-profit corporations, non-profit corporations, benefit corporations, limited liability companies, limited partnerships, limited liability partnerships, and non-resident landlord registrations.
* **Rhode Island Department of State, Business Services** (verification, primary). The official public register served by the Business Portal. Each query reads live against the register and returns legal name, identification number, entity type with domestic / foreign and profit / non-profit qualifiers, date of incorporation or registration in Rhode Island, current status with revocation, withdrawal, or dissolution dates, the principal-office address, the registered-agent name and address with resignation and address-maintained flags, the statutory officers and directors of a corporation or the managers of an LLC, the corporate purpose, the NAICS code with description, registered fictitious / DBA names, prior corporate names, and merger history.
Shareholders and beneficial owners are not collected by Rhode Island at the state level. Authorized share capital is shown on the Trade Register Extract only; it is not returned in the JSON response, and the holders of those shares are not part of the register.
## Company Identifiers
### Query Identifiers
| Identifier Type | Format | Example | Notes |
| - | - | - | - |
| **RI Identification Number** | Nine-digit zero-padded numeric value, no separators | `000015908` | Assigned by the Department of State Business Services at filing. Inputs shorter than nine digits are left-padded with zeros. |
The identification number is always normalized to nine digits before search. Only digits are accepted, up to nine of them: `15908` and `000015908` resolve to the same entity.
### Identifiers in API Response
| Identifier | Format | Example | Found In |
| - | - | - | - |
| `identificationNumber` | Nine-digit zero-padded numeric | `000015908` | All entities |
### Legal Entity Identifier (LEI)
GLEIF is the supplementary data source for this identifier.
`company.identifiers.lei` is returned when a company identifier has a unique match against this jurisdiction's registration or validation references in GLEIF.
An [LEI (Legal Entity Identifier)](https://www.gleif.org/en/about-lei/introducing-the-legal-entity-identifier-lei) has 20 uppercase letters and digits, ending in two check digits.
Coverage varies by entity. The field is omitted when no unambiguous match is available. Lapsed or retired LEIs may be returned; annulled records are excluded.
## Search Capabilities
| Search Type | Pattern | Example | Match Type | Expected Results |
| - | - | - | - | - |
| By Name | 2 to 200 characters | `"Hasbro"` | Begins with (case-insensitive) | Up to 50 |
| By Identification Number | 1 to 9 digits | `000015908` | Exact (after zero-padding) | Exact match returned first (matchType: id); other results may follow |
Name search returns up to 50 rows per query and is bound to currently-active entities. To resolve a known inactive entity, query by identification number instead. The identifier path covers active and inactive entities in one lookup.
### Active companies only
Search can return companies that are no longer active. Each result carries the register's status, so [`activeOnly=true`](/essentials/search#active-companies-only) removes the inactive ones. Name searches only cover active companies and companies revoked within the last year; identification-number lookups reach every company. With the active-only filter, inactive companies are removed from both.
## Quirks & Gotchas
| Quirk | Details |
| - | - |
| **Identification number is zero-padded** | The canonical form is exactly nine digits, left-padded with zeros (`000015908`). Older entities are often displayed with the leading zeros elided, but the canonical form in the API response is always nine digits. |
| **No shareholder or UBO register** | Rhode Island does not publish shareholders or beneficial owners for any entity type. Federal FinCEN beneficial-ownership records are restricted and are not part of this dataset. |
| **Authorized share capital is structural** | For corporations, the register exposes the authorized share classes (class, series, par value, total authorized, total issued and outstanding) but does not identify the holders. The share classes appear on the Trade Register Extract only, not in the JSON response. LLC members are returned as `otherKeyPersons`; managers and managing members are `legalRepresentatives`. |
| **Name history is preserved** | The register tracks all prior legal names for a given entity, including the date of each change. A search by an older name resolves to the same identification number as the current name. |
| **Fictitious names / DBAs sit on the parent** | Registered fictitious or trade names (DBAs) appear on the parent entity's record rather than as standalone records. |
| **Mergers are linked** | When an entity has absorbed others through a merger, the absorbed entities are listed on the surviving record with their identification numbers. The absorbed entities' own records remain searchable and stay flagged as inactive. |
| **Purpose uses a NAICS-based code** | Each entity carries a single NAICS code with a human-readable description, plus a free-text "purpose" paragraph quoting the corporate purpose from the formation filing. The state does not collect NACE or ISIC codes; the API derives them from the NAICS code. |
| **Entity-type composite labels** | The entity-type field is a composite of the domestic / foreign qualifier, the profit / non-profit qualifier (for corporations), and the base form. Examples: `Domestic Profit Corporation`, `Foreign Limited Liability Company`, `Domestic Non-Profit Corporation`. |
## Mappings
### Entity Types
The register publishes entity types as composite labels. The standardized mapping below covers the combinations the API returns.
| Local Label | English Translation | Standardized Form | ISO 20275 |
| - | - | - | - |
| Domestic Profit Corporation | Domestic Profit Corporation | Corporation | Z54A |
| Foreign Profit Corporation | Foreign Profit Corporation | Corporation | |
| Domestic Non-Profit Corporation | Domestic Non-Profit Corporation | Nonprofit Organization | AVLE |
| Foreign Non-Profit Corporation | Foreign Non-Profit Corporation | Nonprofit Organization | |
| Domestic Limited Liability Company | Domestic Limited Liability Company | Limited Liability Company | DRSE |
| Foreign Limited Liability Company | Foreign Limited Liability Company | Limited Liability Company | |
| Domestic Limited Partnership | Domestic Limited Partnership | Partnership | FW66 |
| Foreign Limited Partnership | Foreign Limited Partnership | Partnership | |
| Domestic Limited Liability Partnership | Domestic Limited Liability Partnership | Partnership | - |
| Foreign Limited Liability Partnership | Foreign Limited Liability Partnership | Partnership | - |
| Domestic Benefit Corporation | Domestic Benefit Corporation | Corporation | QMI2 |
| Non-Resident Landlord | Non-Resident Landlord | Other | - |
### Status Values
Active is the implicit default. Inactive entities carry an explicit revocation, withdrawal, or dissolution date on the record. The API returns a normalized `status.localName` plus an `active` boolean.
| Local Status | Active |
| - | - |
| Active | Yes |
| Revoked | No |
| Withdrawn | No |
| Dissolved | No |
The Active database covers currently-effective entities plus any that were revoked within the prior year. The Inactive database holds older revocations, withdrawals, and dissolutions.
### Officer Roles
The register records officers, directors, and managers on each entity. The API surfaces them as either `legalRepresentatives` (declared current office context, with company-specific powers unverified) or `otherKeyPersons` (the registered agent, executive titles, and supporting officers). Most title strings carry a trailing department qualifier (`PRESIDENT, TOYS LICENSING & ENTERTAINMENT`, `DIRECTOR, RISK MANAGEMENT`); known full titles use exact catalogue meaning. A functional title such as `DIRECTOR, RISK MANAGEMENT` is retained as another key person rather than a board director.
| Local Role | Mapped To |
| - | - |
| President | legalRepresentatives |
| Vice-President | legalRepresentatives |
| Secretary | legalRepresentatives |
| Treasurer | legalRepresentatives |
| Director | legalRepresentatives |
| Manager (LLC) | legalRepresentatives |
| Managing Member (LLC) | legalRepresentatives |
| CEO | legalRepresentatives |
| CFO | legalRepresentatives |
| COO | legalRepresentatives |
| Member (LLC) | otherKeyPersons |
| Organizer | otherKeyPersons |
| Incorporator | otherKeyPersons |
| Assistant Secretary | otherKeyPersons |
| Assistant Treasurer | otherKeyPersons |
| EVP, SVP, VP | otherKeyPersons |
| Chief Officer titles | otherKeyPersons |
| Registered Agent | otherKeyPersons |
The registered agent is surfaced as an `otherKeyPersons` entry with `role.standardized: "Registered Agent"`. An agent marked as resigned on the register is omitted. For agents that are corporate entities (such as registered-agent services), the entry carries `type: "company"` with a `legalName`; for individual agents, the entry carries `type: "individual"` with a `fullName`.
## Data Availability
| Datapoint | Available | Notes |
| - | - | - |
| Company profile | Yes | Legal name, identification number, entity type, dates of incorporation or registration, status with revocation / withdrawal / dissolution dates, principal-office address, corporate purpose, NAICS code with description. |
| Registered agent | Yes | Returned as `otherKeyPersons` with `role.standardized: "Registered Agent"`, with the name and full address. A resigned agent is omitted. |
| Legal representatives | Yes | Officers and directors of a corporation (President, Vice-President, Secretary, Treasurer, Director, CEO, CFO, COO) and managers / managing members of an LLC, with their addresses. |
| Other key persons | Yes | Executive roles outside the statutory officers (EVP, SVP, VP, Chief X Officer titles), assistant officers, and the registered agent. |
| Shareholders | No | Not collected by Rhode Island at the state level. Authorized share capital appears on the Trade Register Extract only, and the holders are not part of the register. |
| Ultimate beneficial owners | No | Rhode Island does not maintain a public beneficial-ownership register. |
| Activity codes | Yes | The register's single NAICS code with description, plus ISIC and NACE codes derived from it. |
| Prior names | Trade Register Extract only | The corporate name-change history, with the effective date of each change, is shown on the Trade Register Extract. It is not returned in the JSON response. |
| Fictitious / DBA names | Trade Register Extract only | Registered fictitious or trade names, with the filing date, are shown on the Trade Register Extract. They are not returned in the JSON response. |
| Mergers | Trade Register Extract only | Absorbed entities, with identification number and merger date, are shown on the Trade Register Extract. They are not returned in the JSON response. |
| Trade Register Extract | Yes | Printable PDF of the Department of State entity detail page, captured at request time. Bundled with the company-data block at no extra charge. |
| Certificate of Good Standing | Planned | The official Department of State Certificate of Good Standing is identified and documented but not yet generally available. Pricing and availability will be on the live pricing page once enabled. |
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.