---
title: "Firm export"
method: GET
path: "/exports/firms"
tags: ["Exports"]
---

# Firm export

`GET /exports/firms`

## Request

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

Export firm rows as json or csv using the same Firm type, financial and correlated role filters as firm search. CSV uses the `fields` order shown in the JSON response. Credits are charged by actual delivered rows. Requires the `public_api_exports` entitlement.

## Query parameters

- `financial.sec_regulated_aum_gte_usd` number
- `financial.sec_regulated_aum_lte_usd` number
- `financial.turnover_gte_gbp` number
- `financial.turnover_lte_gbp` number
- `firm_type` string
- `firm_type.category` string
- `firm_type.tag` string
- `firm_type.tag_dimension` string
- `format` string
- `limit` integer
- `mifid_firm` boolean
- `role.code` string
- `role.source_authority` 'fca'
- `role.start_from` string, date
- `role.start_to` string, date
- `role.status` string

## Response `200`

- FirmExportResponse
  - `delivery_id` string, uuid, nullable
  - `format` string, required
  - `count` integer, required
  - `exported_count` integer, required
  - `limit` integer, required
  - `fields` string[], required
  - `results` object[], required
  - `export_usage` ExportUsage, required
    - `credits_consumed` integer, required
    - `credits_remaining` integer, required
    - `quota` integer, required
    - `owner_type` 'individual' | 'organisation', required: * `individual` - individual * `organisation` - organisation
    - `resets_at` string, date-time, required

## Other responses

- `400`
- `403`
- `429`
- `503`

---

[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)