> ## 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.

# Marshall Islands

> Country-specific identifiers, data sources, and implementation details

## Start here

This guide contains public integration notes for Marshall Islands. 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.

<Card title="Marshall Islands coverage, pricing, and sources" icon="arrow-up-right-from-square" href="https://topograph.co/pricing/mh">
  Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
</Card>

<Warning>
  This jurisdiction may be in preview or limited availability. Check the live pricing page or contact support before relying on it in production.
</Warning>

<Note>
  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.
</Note>

## Table of Contents

* [Data Sources](#data-sources)
* [Company Identifiers](#company-identifiers)
* [Search Capabilities](#search-capabilities)
* [Quirks & Gotchas](#quirks--gotchas)
* [Mappings](#mappings)
* [Data Availability](#data-availability)
* [Example API Responses](#example-api-responses)

## Data Sources

Marshall Islands data comes from a single official source, the **Republic of the Marshall Islands Corporate Register**, maintained by International Registries, Inc. It covers non-resident and resident entities: corporations, limited liability companies, partnerships, limited partnerships, foreign maritime entities and resident entities.

* **Marshall Islands Corporate Register** (`resources.register-iri.com`). The **sole source** for search, the company profile, the registered agent, and the Non-Resident Entity Report. Every request reads the register live; there is no bulk extract of this register.

The register publishes the entity number, legal name, entity type, status, existence (formation) date, and the registered agent's name and address. Officers, directors, members and shareholders are not publicly available.

<Note>
  **Modes.** Both `mode: "onboarding"` and `mode: "verification"` (the default) read the same live register and return the same fields. Onboarding results are flagged `authoritative: false`; verification results are authoritative. See [Modes](/essentials/modes).
</Note>

## Company Identifiers

### Query Identifiers

| Identifier Type   | Format                      | Example  | Notes                                                                                                                                                  |
| ----------------- | --------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Entity Number** | Numeric, typically 6 digits | `127599` | Primary identifier assigned by the Marshall Islands Corporate Register. Appears on the register's entity detail and on the Non-Resident Entity Report. |

### Identifiers in API Response

| Identifier     | Format                      | Example  | Found In     |
| -------------- | --------------------------- | -------- | ------------ |
| `entityNumber` | Numeric, typically 6 digits | `127599` | All entities |

<Note>
  The entity number is the only public identifier. The Marshall Islands does not issue tax identification or VAT numbers for non-resident entities.
</Note>

## Search Capabilities

| Search Type      | Pattern             | Example           | Match Type              | Expected Results                         |
| ---------------- | ------------------- | ----------------- | ----------------------- | ---------------------------------------- |
| By Entity Number | 3 to 8 digits       | `127599`          | Exact (`matchType: id`) | Single result or none                    |
| By Name          | 4 to 200 characters | `"PACIFIC OCEAN"` | Begins with             | Multiple results across all entity types |

<Note>
  **Name search** returns entities whose legal name starts with your query, so start from the first word of the name. The query must be at least 4 characters. Results cover all six entity types and are de-duplicated by entity number. A result whose legal name matches the query exactly is returned with `matchType: exactLegalName`.
</Note>

<Note>
  **Numeric queries** are treated as entity numbers only. A query made entirely of digits is not run as a name search.
</Note>

Both searches query the register live. Search results carry the entity number (`id`) and legal name; status, entity type and address come from the `company` datapoint.

## Quirks & Gotchas

| Quirk                                                | Details                                                                                                                                                                                     |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **No officers, directors or shareholders**           | The register does not disclose directors, officers, managers, members or shareholders. Only the registered agent is public, so `legalRepresentatives` and `shareholders` are not available. |
| **Registered agent returned as an other key person** | The registered agent is returned under `otherKeyPersons` with the role `Registered Agent`, as a company. It is not an officer of the entity.                                                |
| **Legal address is the registered agent's office**   | Non-resident entities have no separate registered office. `legalAddress` is the registered agent's address in Majuro, so many entities share the same address.                              |
| **No UBO register**                                  | The Marshall Islands does not maintain a public beneficial ownership register.                                                                                                              |
| **No activity codes**                                | The register does not collect industry classification codes, so no NACE or ISIC codes are returned.                                                                                         |
| **Name search is prefix-based**                      | Name search matches the beginning of the legal name, not words in the middle of it. Search by entity number when you have it.                                                               |
| **Status is not good standing**                      | The register's public record shows existence and status only, and the register marks its entity record as not a statement of good standing. A Certificate of Good Standing is not offered.  |
| **Registration date**                                | `registrationDate` is the register's existence (formation) date.                                                                                                                            |

## Mappings

### Company Status

Status is mapped deterministically from the register's status value.

| Local Status | English Translation | `active` |
| ------------ | ------------------- | -------- |
| Active       | Active              | `true`   |
| Annulled     | Annulled            | `false`  |
| Dissolved    | Dissolved           | `false`  |
| Transferred  | Transferred         | `false`  |
| Conversion   | Conversion          | `false`  |

A status value outside this list is returned with its `localName` and no `active` flag.

### Legal Forms

Legal form is mapped deterministically from the register's entity type, a closed list of six values. The register does not publish ISO 20275 (ELF) codes, so `iso20275Code` is not returned.

| Local Name                | English Translation       | Standardized                |
| ------------------------- | ------------------------- | --------------------------- |
| Corporation               | Corporation               | `Corporation`               |
| Limited Liability Company | Limited Liability Company | `Limited Liability Company` |
| Partnership               | Partnership               | `Partnership`               |
| Limited Partnership       | Limited Partnership       | `Partnership`               |
| Foreign Maritime          | Foreign Maritime Entity   | `Other`                     |
| Resident Entity           | Resident Entity           | `Other`                     |

### Legal Representatives

Not available. The register does not publish directors, officers or managers.

### Other Key Persons

| Local Role Name  | Standardized       | Holder  |
| ---------------- | ------------------ | ------- |
| Registered Agent | `Registered Agent` | Company |

The registered agent is returned with its legal name and address.

### Shareholders

Not available. Shareholder and member registers are held privately by the entity and are not published by the register.

### Activity Code Mapping

Not available. The register does not collect industry classification codes.

## Data Availability

### Data Availability Matrix

The same fields are returned in onboarding and verification mode.

| Data Point            | Available | Notes                                          |
| --------------------- | --------- | ---------------------------------------------- |
| Company name          | Yes       | Current legal name                             |
| Entity number         | Yes       | `identifiers.entityNumber`                     |
| Company status        | Yes       | See [Company Status](#company-status)          |
| Legal form            | Yes       | Closed list of six entity types                |
| Registration date     | Yes       | Existence (formation) date                     |
| Legal address         | Yes       | The registered agent's office                  |
| Registered agent      | Yes       | Under `otherKeyPersons`, with name and address |
| Legal representatives | No        | Not published by the register                  |
| Shareholders          | No        | Not published by the register                  |
| UBOs                  | No        | No public beneficial ownership register        |
| Activity codes        | No        | Not collected by the register                  |
| Tax IDs               | No        | Not issued for non-resident entities           |

### Documents by Company Type

| Response Key           | Document                         | Entity Types | Contents                                                                                                      |
| ---------------------- | -------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------- |
| `tradeRegisterExtract` | Non-Resident Entity Report (PDF) | All          | Entity number, legal name, entity type, status, existence (formation) date, registered agent name and address |

The Trade Register Extract is included with the company data. It is listed for every entity through the `availableDocuments` datapoint. See the [pricing page](https://topograph.co/pricing/mh) for current pricing.

## Example API Responses

<AccordionGroup>
  <Accordion title="Search by name">
    ```bash theme={null}
    curl "https://api.topograph.co/v2/search?country=MH&query=PACIFIC%20EXAMPLE" \
      -H "x-api-key: YOUR_API_KEY"
    ```

    ```json theme={null}
    [
      {
        "id": "123456",
        "countryCode": "MH",
        "legalName": "PACIFIC EXAMPLE SHIPPING LTD",
        "matchReason": { "matchType": "default" }
      },
      {
        "id": "123789",
        "countryCode": "MH",
        "legalName": "PACIFIC EXAMPLE HOLDINGS LLC",
        "matchReason": { "matchType": "default" }
      }
    ]
    ```
  </Accordion>

  <Accordion title="Search by entity number">
    ```bash theme={null}
    curl "https://api.topograph.co/v2/search?country=MH&query=123456" \
      -H "x-api-key: YOUR_API_KEY"
    ```

    ```json theme={null}
    [
      {
        "id": "123456",
        "countryCode": "MH",
        "legalName": "PACIFIC EXAMPLE SHIPPING LTD",
        "matchReason": { "matchType": "id", "identifier": { "entityNumber": "123456" } }
      }
    ]
    ```
  </Accordion>

  <Accordion title="Active corporation with registered agent">
    ```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": "MH", "id": "123456", "dataPoints": ["company", "otherKeyPersons"]}'
    ```

    ```json theme={null}
    {
      "company": {
        "id": "123456",
        "countryCode": "MH",
        "identifiers": { "entityNumber": "123456" },
        "legalName": "PACIFIC EXAMPLE SHIPPING LTD",
        "registrationDate": "2024-08-21",
        "status": { "localName": "Active", "active": true },
        "legalForm": {
          "localName": "Corporation",
          "englishTranslation": "Corporation",
          "standardized": "Corporation"
        },
        "legalAddress": { "addressLine1": "Example Complex, Example Road", "city": "Majuro", "postalCode": "96960", "countryCode": "MH" }
      },
      "otherKeyPersons": [
        {
          "type": "company",
          "role": { "localName": "Registered Agent", "standardized": "Registered Agent" },
          "company": {
            "legalName": "EXAMPLE REGISTERED AGENT, INC.",
            "countryCode": "MH",
            "legalAddress": { "addressLine1": "Example Complex, Example Road", "city": "Majuro", "postalCode": "96960", "countryCode": "MH" }
          }
        }
      ]
    }
    ```
  </Accordion>

  <Accordion title="Dissolved limited liability company">
    ```json theme={null}
    {
      "company": {
        "id": "123789",
        "countryCode": "MH",
        "identifiers": { "entityNumber": "123789" },
        "legalName": "PACIFIC EXAMPLE HOLDINGS LLC",
        "registrationDate": "2015-03-02",
        "status": { "localName": "Dissolved", "active": false },
        "legalForm": {
          "localName": "Limited Liability Company",
          "englishTranslation": "Limited Liability Company",
          "standardized": "Limited Liability Company"
        },
        "legalAddress": { "addressLine1": "Example Complex, Example Road", "city": "Majuro", "postalCode": "96960", "countryCode": "MH" }
      }
    }
    ```
  </Accordion>

  <Accordion title="Available documents">
    ```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": "MH", "id": "123456", "dataPoints": ["availableDocuments"]}'
    ```

    ```json theme={null}
    {
      "documents": {
        "tradeRegisterExtract": {
          "id": "doc_tre_123",
          "name": "Trade Register Extract",
          "format": "pdf"
        }
      }
    }
    ```
  </Accordion>

  <Accordion title="Downloaded Trade Register Extract">
    ```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": "MH", "id": "123456", "documents": ["doc_tre_123"]}'
    ```

    ```json theme={null}
    {
      "documents": {
        "tradeRegisterExtract": {
          "id": "doc_tre_123",
          "name": "Trade Register Extract",
          "format": "pdf",
          "url": "https://files.example.com/documents/doc_tre_123.pdf?sig=..."
        }
      }
    }
    ```
  </Accordion>
</AccordionGroup>