# IDFinder

*IDFinder* uses proprietary-powered searching to find a company's official registration number given its legal name and jurisdiction. It cross-references multiple sources to verify results.

## Find Registration ID

### Request

```
POST https://api.revolutio.systems/idfinder
```

**Headers**

| Header          | Value              |
| --------------- | ------------------ |
| `Content-Type`  | `application/json` |
| `Authorization` | `Bearer <idToken>` |

**Body**

```json
{
  "legalName": "Revolut Ltd",
  "jurisdiction": "GB"
}
```

| Field          | Type   | Required | Description                                       |
| -------------- | ------ | -------- | ------------------------------------------------- |
| `legalName`    | string | Yes      | The legal name of the company to look up          |
| `jurisdiction` | string | Yes      | ISO jurisdiction code (e.g., `GB`, `DE`, `US-DE`) |

### Response

{% tabs %}
{% tab title="200 OK" %}
Returns a JSON array of matched registration identifiers:

```json
[
  {
    "companyName": "REVOLUT LTD",
    "registrationNumber": "09215191",
    "identifierType": "Company number",
    "country": "GB"
  }
]
```

| Field                | Type   | Description                                       |
| -------------------- | ------ | ------------------------------------------------- |
| `companyName`        | string | The official legal name as registered (uppercase) |
| `registrationNumber` | string | The verified registration identifier              |
| `identifierType`     | string | The type of identifier (varies by jurisdiction)   |
| `country`            | string | The jurisdiction code                             |

For German companies (`DE`), an additional field is included:

```json
[
  {
    "companyName": "SIEMENS AKTIENGESELLSCHAFT",
    "registrationNumber": "HRB 6684",
    "identifierType": "Registernummer",
    "country": "DE",
    "registerCourt": "Amtsgericht Munchen"
  }
]
```

An **empty array** `[]` is returned when no verified match is found.
{% endtab %}

{% tab title="400 Bad Request" %}

```json
{
  "error": "Missing legalName and/or jurisdiction"
}
```

{% endtab %}

{% tab title="402 Payment Required" %}

```json
{
  "error": "Insufficient volume remaining. Please top up.",
  "volume_remaining": 0
}
```

{% endtab %}

{% tab title="500 / 502" %}

```json
{
  "error": "No results found for requested legal name in Germany"
}
```

{% endtab %}
{% endtabs %}

## Supported Jurisdictions and Identifier Types Returned

The identifier type returned depends on the jurisdiction. Below are some examples:

<table><thead><tr><th width="156.19140625">Jurisdiction</th><th width="79.9375" align="center">ISO</th><th width="499.546875">Identifier Type(s)</th></tr></thead><tbody><tr><td><strong>Australia</strong></td><td align="center"><code>AU</code></td><td>ABN/ACN/ARBN</td></tr><tr><td><strong>Austria</strong></td><td align="center"><code>AT</code></td><td>FirmenbuchNummer</td></tr><tr><td><strong>Belgium</strong></td><td align="center"><code>BE</code></td><td>Enterprise number</td></tr><tr><td><strong>Brazil</strong></td><td align="center"><code>BR</code></td><td>CNPJ</td></tr><tr><td><strong>Denmark</strong></td><td align="center"><code>DK</code></td><td>CVR-nummer</td></tr><tr><td><strong>Estonia</strong></td><td align="center"><code>EE</code></td><td>Registry code</td></tr><tr><td><strong>Finland</strong></td><td align="center"><code>FI</code></td><td>Business ID</td></tr><tr><td><strong>France</strong></td><td align="center"><code>FR</code></td><td>SIREN</td></tr><tr><td><strong>Germany</strong></td><td align="center"><code>DE</code></td><td>Registernummer</td></tr><tr><td><strong>Hong Kong</strong></td><td align="center"><code>HK</code></td><td>BRN</td></tr><tr><td><strong>Japan</strong></td><td align="center"><code>JP</code></td><td>Japan Corporate Number</td></tr><tr><td><strong>Luxembourg</strong></td><td align="center"><code>LU</code></td><td>RCS Number</td></tr><tr><td><strong>Netherlands</strong></td><td align="center"><code>NL</code></td><td>KVK Nummer</td></tr><tr><td><strong>Poland</strong></td><td align="center"><code>PL</code></td><td>KRS</td></tr><tr><td><strong>Singapore</strong></td><td align="center"><code>SG</code></td><td>UEN</td></tr><tr><td><strong>Spain</strong></td><td align="center"><code>ES</code></td><td>NIF tax ID</td></tr><tr><td><strong>Switzerland</strong></td><td align="center"><code>CH</code></td><td>UID</td></tr><tr><td><strong>United Kingdom</strong></td><td align="center"><code>GB</code></td><td>Company number</td></tr></tbody></table>

### Example (cURL)

```bash
curl -X POST https://api.revolutio.systems/idfinder \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"legalName": "Apple Inc", "jurisdiction": "US-CA"}'
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://equinoxe-systems.gitbook.io/revolutio-api/idfinder.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.