Hackford Complaints API
The Complaints API from Hackford — 1 operation(s) for complaints.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/hackforddata-com:hackforddata-com-complaints-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
openapi: 3.2.0
info:
title: Hackford Public Complaints 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: Complaints
paths:
/firms/{hackford_id}/fos-decisions:
get:
operationId: firms_fos_decisions_retrieve
description: Return displayable published FOS decisions linked to one canonical firm.
summary: Firm FOS decisions
parameters:
- in: query
name: decision_date_from
schema:
type: string
format: date
description: Decision date on or after this date.
- in: query
name: decision_date_to
schema:
type: string
format: date
description: Decision date on or before this date.
- in: path
name: hackford_id
schema:
type: string
required: true
- in: query
name: page
schema:
type: integer
- in: query
name: page_size
schema:
type: integer
description: Page size, capped at 100.
- in: query
name: product_category
schema:
type: string
description: One or more comma-separated FOS product categories.
- in: query
name: upheld
schema:
type: boolean
description: Whether the published decision was upheld.
tags:
- Complaints
security:
- OAuthAccessTokenAuth: []
- PublicApiKeyAuth: []
- jwtAuth: []
- tokenAuth: []
- cookieAuth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/FirmFosDecisionsResponse'
description: ''
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicApiError'
description: ''
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicApiError'
description: ''
'429':
content:
application/json:
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
FirmFosDecisionsResponse:
type: object
properties:
firm:
$ref: '#/components/schemas/FirmPermissionFirm'
count:
type: integer
page:
type: integer
page_size:
type: integer
next:
type:
- string
- 'null'
previous:
type:
- string
- 'null'
results:
type: array
items:
$ref: '#/components/schemas/FirmFosDecisionRow'
source:
type: object
additionalProperties: {}
required:
- count
- firm
- next
- page
- page_size
- previous
- results
- source
OwnerTypeEnum:
enum:
- individual
- organisation
type: string
description: '* `individual` - individual
* `organisation` - organisation'
FirmFosDecisionRow:
type: object
properties:
decision_reference:
type:
- string
- 'null'
decision_date:
type:
- string
- 'null'
format: date
outcome:
type:
- string
- 'null'
product_category:
type:
- string
- 'null'
decision_url:
type:
- string
- 'null'
business_name:
type:
- string
- 'null'
excerpt:
type:
- string
- 'null'
required:
- business_name
- decision_date
- decision_reference
- decision_url
- excerpt
- outcome
- product_category
FirmIdentifiers:
type: object
properties:
fca_frn:
type:
- string
- 'null'
sec_crd:
type:
- string
- 'null'
sec_file:
type:
- string
- 'null'
cik:
type:
- string
- 'null'
companies_house:
type:
- string
- 'null'
lei:
type:
- string
- 'null'
FirmPermissionFirm:
type: object
properties:
hackford_id:
type: string
display_name:
type: string
canonical_url:
type: string
identifiers:
$ref: '#/components/schemas/FirmIdentifiers'
required:
- canonical_url
- display_name
- hackford_id
- identifiers
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"