---
title: "Resolve a name or registry number to candidate files"
method: GET
path: "/v1/search"
tags: ["search"]
---

# Resolve a name or registry number to candidate files

`GET /v1/search`

## Request

- Base URL: `https://jid.com`
- URL: `https://jid.com/v1/search`
- Auth: one of:
  - none
  - HTTP bearer

Free (not a check). Identifiers first (FEI, LEI, CIK, DUNS, NDC labeler, USDOT, NPI, EIN, UEI, state numbers, French SIREN/SIRET), then name: exact, begins with, contains, similar. A SIREN or SIRET no file holds is looked up live on SIRENE (France) and becomes a file; with country=FR a name is also searched on SIRENE (up to 5 business units, filed on demand, listed first).

## Query parameters

- `q` string, required
- `country` string

## Response `200`

Candidates

- SearchResponse
  - `query` string
  - `results` object[]
    - `id` string
    - `name` string
    - `kind` string
    - `status` string
    - `status_summary` string, nullable
    - `matched_on` string
    - `url` string
    - `verify_url` string
  - `website_declared` WebsiteDeclared[]: Businesses with no Jid file whose own website names them (tier website_declared). Not files and not confirmed by an official register.
    - `tier` 'website_declared'
    - `domain` string
    - `legal_name` string: As printed, with its legal form
    - `trade_name` string, nullable
    - `address` string, nullable: As printed; null when the site prints addresses in several states
    - `state` string, nullable
    - `postal_code` string, nullable
    - `source_url` string
    - `read_at` string, date-time
    - `how` string
    - `note` string

## Other responses

- `400`: Error
- `429`: Error

---

[API](https://skmtc.dev/jid/apis/jid-api.md) · [All operations](https://skmtc.dev/jid/apis/jid-api/llms.txt) · [OpenAPI document](https://skmtc.dev/jid/apis/jid-api/revisions/453a19ce3d5d?raw)