GET /v1/firms/{id}

Call	GET /v1/firms/{id}
Price	free
Scope	index:read
Operation id	getFirm

What it does

Public facts (type, size band, HQ, status) and every known identifier of a firm, each with its source and date. Free. Scope: index:read.

Example request

Copy it as curl. Set VERDICT_API_KEY first; uuidgen makes a fresh Idempotency-Key.

Request

curl -X GET 'https://api.askverdict.io/v1/firms/frm_01JC3Z4Y8R9K2M5N7P1Q3S5T7V' \
  -H "Authorization: Bearer $VERDICT_API_KEY"

Example response

200: The firm.

200 response

{
  "id": "frm_01JC3Z4Y8R9K2M5N7P1Q3S5T7V",
  "name": "Northfield Capital Advisors LLC",
  "domain": "northfieldcapital.com",
  "identifiers": {
    "crd": "298765",
    "lei": "549300ABCDEF12345678"
  },
  "type": "investment_adviser",
  "size_band": "small",
  "hq": {
    "country": "US",
    "region": "MA",
    "city": "Boston"
  },
  "status": "active",
  "provisional": false,
  "crosswalk": [
    {
      "kind": "crd",
      "value": "298765",
      "source": "sec_edgar",
      "observed_at": "2026-10-28"
    },
    {
      "kind": "lei",
      "value": "549300ABCDEF12345678",
      "source": "gleif",
      "observed_at": "2026-11-02"
    },
    {
      "kind": "domain",
      "value": "northfieldcapital.com",
      "source": "sec_edgar",
      "observed_at": "2026-10-28"
    },
    {
      "kind": "name_variant",
      "value": "Northfield Capital",
      "source": "wikidata",
      "observed_at": "2026-10-30"
    }
  ],
  "created_at": "2026-09-14T08:12:00Z",
  "updated_at": "2026-11-02T06:40:00Z"
}

Parameters

Name	In	Type	Required	Description
id	path	string	yes	The firm id.
x-verdict-version	header	string	no	API version to use, a date. Defaults to the version current when the key was created. The current version is 2026-11-01.

Response fields (200)

Schema Firm.

Field	Type	Required	Description
id	string	yes	The firm id.
name	string	yes	Canonical firm name.
domain	string or null	yes	Primary web domain, if known.
identifiers	object	yes	Registry identifiers, by kind.
identifiers.lei	string	no	Legal Entity Identifier.
identifiers.cik	string	no	SEC Central Index Key.
identifiers.crd	string	no	CRD number.
identifiers.companies_house	string	no	UK Companies House number.
identifiers.wikidata	string	no	Wikidata item id.
type	enum: “operating_company”, “investment_adviser”, “broker_dealer”, “investment_fund”, “nonprofit”, “public_body”, “other”, “unknown”	yes	Coarse firm type.
size_band	enum: “micro”, “small”, “medium”, “large”, “enterprise”, “unknown”	yes	Employee-count size band.
hq	object	yes	Headquarters location.
hq.country	string or null	yes	ISO 3166-1 alpha-2 country.
hq.region	string or null	yes	State, county or region, as the registry gives it.
hq.city	string or null	yes	City.
status	enum: “active”, “inactive”, “dissolved”, “unknown”, “merged”	yes	Registry status.
provisional	boolean	yes	True when the firm was created from an unresolved reference and awaits nightly reconciliation.
crosswalk	array of object	yes	Every known identifier, including name variants and secondary domains, with its source.
crosswalk[].kind	enum: “domain”, “lei”, “cik”, “crd”, “companies_house”, “wikidata”, “name_variant”	yes	Identifier kind.
crosswalk[].value	string	yes	Identifier value.
crosswalk[].source	enum: “sec_edgar”, “gleif”, “companies_house”, “wikidata”, “request”	yes	Source that reported the identifier: an index source, or request when it came from a caller’s reference (provisional firms).
crosswalk[].observed_at	string (date)	yes	Date the source last reported the identifier.
created_at	string (date-time)	yes	When the firm entered the index.
updated_at	string (date-time)	yes	When the firm’s record last changed.

Errors

Errors are RFC 9457 problem details and are never billed. Branch on type. See Errors.

Status	Meaning
400	Invalid request: malformed JSON, an unknown field, a failed constraint or a size limit (invalid_request).
401	Missing, malformed, revoked or expired API key, or a bad webhook signature (unauthorized).
403	The key lacks the scope this operation needs (forbidden_scope).
404	The resource does not exist in this organization (not_found).
429	Rate limited (rate_limited). Wait Retry-After seconds.
500	Unexpected server error (internal). Not billed; retry with the same Idempotency-Key.

Try it

Open the interactive reference to send this request from the browser. The full document is at /openapi.json.