Hackford Exports API

The Exports API from Hackford — 2 operation(s) for exports.

GitHub OpenAPI

Operations 2

GET /exports/firms Firm export #
POST /exports/target-list Target-list export #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/hackforddata-com:hackforddata-com-exports-api"
All apis
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.

Get an API 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 Specification

hackforddata-com-exports-api-openapi.yml Raw ↑
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"