---
title: "Firm people"
method: GET
path: "/firms/{hackford_id}/people"
tags: ["People"]
---

# Firm people

`GET /firms/{hackford_id}/people`

## Request

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

Return FCA Extract approved-function and role-holder records for a canonical firm. Results are current roles by default. Customer-visible LinkedIn records are returned on the person and firm-scoped email records are returned on current roles.

## Path parameters

- `hackford_id` string, required

## Query parameters

- `current` string
- `page` integer
- `page_size` integer
- `role` string
- `role_code` string
- `role_group` string
- `source_authority` 'fca'
- `status` string

## Response `200`

- FirmPeopleResponse
  - `firm` FirmPeopleFirm, required
    - `hackford_id` string, required
    - `display_name` string, required
    - `canonical_url` string, 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
  - `count` integer, required
  - `page` integer, required
  - `page_size` integer, required
  - `next` string, nullable, required
  - `previous` string, nullable, required
  - `source` unknown
  - `results` FirmPeopleRow[], required
    - `person` PublicPersonWithContacts, required
      - `individual_reference_number` string, nullable, required
      - `full_name` string, nullable, required
      - `first_name` string, nullable, required
      - `last_name` string, nullable, required
      - `linkedin` PublicPersonLinkedIn[], required
        - `linkedin_url` string, uri, required
        - `updated_at` string, date-time, nullable, required
    - `role` PublicPersonRoleWithContacts, required
      - `title` string, nullable, required
      - `source_authority` union, required
        - 'fca': * `fca` - fca
        - unknown
      - `start_date` string, date, nullable, required
      - `end_date` string, date, nullable, required
      - `is_current` boolean, required
      - `emails` PublicPersonEmail[], required
        - `email` string, email, required
        - `email_confidence` 'high' | 'medium' | 'low': * `high` - high * `medium` - medium * `low` - low
        - `updated_at` string, date-time, nullable, required

## Other responses

- `404`
- `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)