Hackford Exports API
The Exports API from Hackford — 2 operation(s) for exports.
The Exports API from Hackford — 2 operation(s) for exports.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/hackforddata-com:hackforddata-com-exports-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Hackford Public Exports API
version: v1
description: Versioned public API for Hackford regulated-firm intelligence. Firm type is Hackford's public regulated-firm grouping contract.
contact:
email: support@hackforddata.com
servers:
- url: https://api.hackforddata.com/v1
description: Production
tags:
- name: Exports
paths:
/exports/firms:
get:
operationId: exports_firms_retrieve
description: 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.
summary: Firm export
parameters:
- in: query
name: financial.sec_regulated_aum_gte_usd
schema:
type: number
description: SEC Form ADV regulated AUM at least this many USD.
- in: query
name: financial.sec_regulated_aum_lte_usd
schema:
type: number
description: SEC Form ADV regulated AUM at most this many USD.
- in: query
name: financial.turnover_gte_gbp
schema:
type: number
description: Latest annual-accounts turnover at least this many GBP.
- in: query
name: financial.turnover_lte_gbp
schema:
type: number
description: Latest annual-accounts turnover at most this many GBP.
- in: query
name: firm_type
schema:
type: string
description: One or more comma-separated Firm type codes.
- in: query
name: firm_type.category
schema:
type: string
description: One or more comma-separated Firm type category codes.
- in: query
name: firm_type.tag
schema:
type: string
description: Firm type tag code.
- in: query
name: firm_type.tag_dimension
schema:
type: string
description: Firm type tag dimension.
- in: query
name: format
schema:
type: string
description: 'Export format: `json` or `csv`. Defaults to `json`.'
- in: query
name: limit
schema:
type: integer
description: Maximum rows to export synchronously. Capped at 5000.
- in: query
name: mifid_firm
schema:
type: boolean
description: Filter by current official FCA UK MiFID register membership. Use `true` for members or `false` for FCA firms that are not members.
- in: query
name: role.code
schema:
type: string
description: Comma-separated role codes, correlated with the other role filters.
- in: query
name: role.source_authority
schema:
type: string
enum:
- fca
description: Role source authority. Public API v1 role rows come from FCA Extract.
- in: query
name: role.start_from
schema:
type: string
format: date
description: Role start date on or after this YYYY-MM-DD date.
- in: query
name: role.start_to
schema:
type: string
format: date
description: Role start date on or before this YYYY-MM-DD date.
- in: query
name: role.status
schema:
type: string
description: 'Role status: `current` (default), `previous` or `both`.'
tags:
- Exports
security:
- OAuthAccessTokenAuth: []
- PublicApiKeyAuth: []
- jwtAuth: []
- tokenAuth: []
- cookieAuth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/FirmExportResponse'
examples:
FirmExportJSON:
value:
format: json
count: 1
exported_count: 1
limit: 5000
fields:
- profile_url
- hackford_id
- display_name
- canonical_url
- status_normalised
- authority_keys
- fca_frn
- sec_crd
- sec_file
- cik
- companies_house
- lei
- firm_type.category_code
- firm_type.category_display
- firm_type.code
- firm_type.display
- firm_type.strategy_tags
- firm_type.client_focus_tags
- firm_type.technology_tags
- firm_type.service_tags
- annex1_status
- annex1_frns
- annex1_effective_dates
- annex1_match_basis
- annex1_data_as_at
- aml_registration_types
- aml_registration_frns
- aml_registration_effective_dates
- aml_registration_match_basis
- aml_registration_data_as_at
results:
- hackford_id: fgh456ij
display_name: Example SEC Manager LLC
canonical_url: /firm/fgh456ij/example-sec-manager-llc
status_normalised: active
authority_keys: sec
fca_frn: null
sec_crd: '332579'
sec_file: 801-91002
cik: '0001234567'
companies_house: null
lei: 5493001KJTIIGC8Y1R12
firm_type.category_code: investment_management
firm_type.category_display: Investment management
firm_type.code: hedge_fund_manager
firm_type.display: Hedge fund manager
firm_type.strategy_tags: hedge_fund
firm_type.client_focus_tags: pooled_vehicles
firm_type.technology_tags: ''
firm_type.service_tags: portfolio_management
export_usage:
credits_consumed: 1
credits_remaining: 24999
quota: 25000
owner_type: organisation
resets_at: '2026-10-08T17:00:00+01:00'
summary: Firm export JSON
text/csv:
schema:
$ref: '#/components/schemas/FirmExportResponse'
description: ''
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicApiError'
text/csv:
schema:
$ref: '#/components/schemas/PublicApiError'
description: ''
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicApiError'
text/csv:
schema:
$ref: '#/components/schemas/PublicApiError'
description: ''
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicApiError'
text/csv:
schema:
$ref: '#/components/schemas/PublicApiError'
description: ''
'503':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicApiError'
text/csv:
schema:
$ref: '#/components/schemas/PublicApiError'
description: ''
/exports/target-list:
post:
operationId: exports_target_list_create
description: Export one row per firm with Firm type, people, relationship and financial summary columns for compliance-consultancy target lists. Credits are charged by actual delivered rows. Requires the `public_api_exports` entitlement.
summary: Target-list export
parameters:
- in: query
name: format
schema:
type: string
enum:
- csv
- json
tags:
- Exports
requestBody:
content:
application/json:
schema:
type: object
additionalProperties: {}
application/x-www-form-urlencoded:
schema:
type: object
additionalProperties: {}
multipart/form-data:
schema:
type: object
additionalProperties: {}
security:
- OAuthAccessTokenAuth: []
- PublicApiKeyAuth: []
- jwtAuth: []
- tokenAuth: []
- cookieAuth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/FirmExportResponse'
text/csv:
schema:
$ref: '#/components/schemas/FirmExportResponse'
description: ''
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicApiError'
text/csv:
schema:
$ref: '#/components/schemas/PublicApiError'
description: ''
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicApiError'
text/csv:
schema:
$ref: '#/components/schemas/PublicApiError'
description: ''
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicApiError'
text/csv:
schema:
$ref: '#/components/schemas/PublicApiError'
description: ''
'503':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicApiError'
text/csv:
schema:
$ref: '#/components/schemas/PublicApiError'
description: ''
components:
schemas:
PublicApiError:
type: object
properties:
detail:
type: string
code:
type: string
export_usage:
$ref: '#/components/schemas/ExportUsage'
required:
- detail
ExportUsage:
type: object
properties:
credits_consumed:
type: integer
credits_remaining:
type: integer
quota:
type: integer
owner_type:
$ref: '#/components/schemas/OwnerTypeEnum'
resets_at:
type: string
format: date-time
required:
- credits_consumed
- credits_remaining
- owner_type
- quota
- resets_at
OwnerTypeEnum:
enum:
- individual
- organisation
type: string
description: '* `individual` - individual
* `organisation` - organisation'
FirmExportResponse:
type: object
properties:
delivery_id:
type:
- string
- 'null'
format: uuid
format:
type: string
count:
type: integer
exported_count:
type: integer
limit:
type: integer
fields:
type: array
items:
type: string
results:
type: array
items:
type: object
additionalProperties: {}
export_usage:
$ref: '#/components/schemas/ExportUsage'
required:
- count
- export_usage
- exported_count
- fields
- format
- limit
- results
securitySchemes:
OAuthAccessTokenAuth:
type: http
scheme: bearer
bearerFormat: OAuth 2.1 access token
PublicApiKeyAuth:
type: http
scheme: bearer
bearerFormat: Hackford public API key
cookieAuth:
type: apiKey
in: cookie
name: sessionid
jwtAuth:
type: http
scheme: bearer
bearerFormat: JWT
tokenAuth:
type: apiKey
in: header
name: Authorization
description: Token-based authentication with required prefix "Token"