---
title: "Enrich CRM firm records"
method: POST
path: "/firms/enrich"
tags: ["Firms"]
---

# Enrich CRM firm records

`POST /firms/enrich`

## Request

- Base URL: `https://api.hackforddata.com/v1`
- URL: `https://api.hackforddata.com/v1/firms/enrich`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - API key in header `Authorization`
  - API key in cookie `sessionid`

Resolve and enrich up to 200 CRM/account records using deterministic identifier matching and bounded firm detail sections.

## Request body

- FirmEnrichRequestRequest
  - `records` BatchFirmResolveRecordRequest[], required
    - `client_reference` string, nullable
    - `hackford_id` string, nullable
    - `fca_frn` string, nullable
    - `sec_crd` string, nullable
    - `sec_file` string, nullable
    - `cik` string, nullable
    - `companies_house` string, nullable
    - `lei` string, nullable
  - `include` string[]

## Response `200`

- FirmEnrichResponse
  - `count` integer, required
  - `matched_count` integer, required
  - `ambiguous_count` integer, required
  - `unmatched_count` integer, required
  - `invalid_count` integer, required
  - `results` FirmEnrichResult[], required
    - `client_reference` string, nullable
    - `match` FirmEnrichMatch, required
      - `status` string, required
      - `matched_on` string[], required
      - `warnings` string[], required
    - `firm` FirmDetail, required
      - `core` FirmCore, required
        - `adviser_bracket_as_of` string, date, nullable
        - `adviser_bracket` string, nullable
        - `adviser_bracket_is_estimated` boolean
        - `adviser_bracket_description` string
        - `hackford_id` string, required
        - `display_name` string, required
        - `slug` string, required
        - `canonical_url` string, required
        - `status_normalised` string, nullable, required
        - `authority_keys` string[], required
        - `website` string, nullable, required
        - `country` string, nullable, required
        - `region` string, nullable, required
        - `city` string, nullable, required
      - `identifiers` FirmIdentifiers, required
        - `fca_frn` string, nullable
        - `sec_crd` string, nullable
        - `sec_file` string, nullable
        - `cik` string, nullable
        - `companies_house` string, nullable
        - `lei` string, nullable
      - `firm_type` FirmType, required
        - `category` FirmTypeReference, required
          - `code` string, required
          - `display_name` string, required
        - `type` FirmTypeReference, required
          - `code` string, required
          - `display_name` string, required
        - `tags` FirmTypeTags, required
          - `technology` FirmTypeTag[], required
            - `code` string, required
            - `display_name` string, required
          - `strategy` FirmTypeTag[], required
            - `code` string, required
            - `display_name` string, required
          - `client_focus` FirmTypeTag[], required
            - `code` string, required
            - `display_name` string, required
          - `service` FirmTypeTag[], required
            - `code` string, required
            - `display_name` string, required
      - `authorities` FirmAuthorities, required
        - `fca` FirmAuthoritySection, required
          - `is_present` boolean, required
          - `is_entitled` boolean
          - `redacted` boolean
          - `data` unknown, required
        - `sec` FirmAuthoritySection, required
          - `is_present` boolean, required
          - `is_entitled` boolean
          - `redacted` boolean
          - `data` unknown, required
        - `psd` FirmAuthoritySection, required
          - `is_present` boolean, required
          - `is_entitled` boolean
          - `redacted` boolean
          - `data` unknown, required
        - `esma` FirmAuthoritySection, required
          - `is_present` boolean, required
          - `is_entitled` boolean
          - `redacted` boolean
          - `data` unknown, required
      - `links` FirmLinks, required
        - `canonical` string, required
        - `people` string
        - `relationships` string
      - `meta` FirmMeta, required
        - `source_coverage` string[], required
        - `last_refreshed` string, date, nullable, required
        - `limitations` string[], required
      - `people_summary` unknown
      - `relationships_summary` unknown
      - `financials_summary` unknown
      - `sec_summary` unknown
      - `permissions_summary` unknown

## Other responses

- `400`
- `429`

---

[API](https://skmtc.dev/hackforddata/apis/hackford-public-api.md) · [All operations](https://skmtc.dev/hackforddata/apis/hackford-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hackforddata/apis/hackford-public-api/revisions/ac8a53f8beb0?raw)