generated: '2026-07-25'
method: searched
source: >-
  FCA FIRDS/FITRS technical specifications (FCA published) + live anonymous
  responses from https://api.data.fca.org.uk ; FS Register resource shape from
  community client documentation (the FCA reference is behind the portal login)
note: >-
  No OpenAPI exists to derive an entity graph from, so this model is assembled
  from two kinds of evidence and the provenance is marked per entity. The data
  publication entities are fully verified — the record shape below is copied from
  live responses and from the FCA's own technical specifications. The FS Register
  entities are marked `verified: false` because the FCA's reference documentation
  is behind the developer portal login and every anonymous probe under
  /services/V0.1 returns the same 403 regardless of whether the path is real.
entities:
- name: FIRDSFile
  api: FCA Data Publication API
  verified: true
  index: fca_data_firds_files
  underlying_index: fca-firds-downloadfiles
  description: >-
    One published UK instrument reference data file artefact (full, delta or
    invalid-instrument file) generated by FCA FIRDS.
  id_field: _id
  fields:
  - name: download_link
    type: uri
    example: https://data.fca.org.uk/artefacts/FIRDS/DLTINS_20210102_01of03.zip
    note: the artefact itself; downloads are explicitly exempt from throttling
  - name: file_type
    type: string
    enum: [FULINS, DLTINS, INVINS]
    searchable: true
  - name: file_name
    type: string
    pattern: <TYPE>_<YYYYMMDD>_<Key1>of<Key2>.zip
    searchable: true
  - name: publication_date
    type: date
    format: YYYY-MM-DD
    searchable: true
  - name: last_refreshed
    type: date-time
    format: ISO 8601
  volume:
    hits_total: 11583
    observed: '2026-07-25'
- name: FITRSFile
  api: FCA Data Publication API
  verified: true
  index: fca_data_fitrs_files
  underlying_index: fca-fitrs-downloadfiles
  description: >-
    One published UK transparency calculation result file artefact generated by
    FCA FITRS.
  id_field: _id
  fields:
  - name: download_link
    type: uri
    example: https://data.fca.org.uk/artefacts/FITRS/FILES/DLTECR_20221212_1of1.zip
  - name: file_type
    type: string
    enum: [Full, Delta]
    searchable: true
  - name: file_name
    type: string
    searchable: true
  - name: instrument_type
    type: string
    example: Equity Instruments
    searchable: true
  - name: publication_date
    type: date
    format: YYYY-MM-DD
    searchable: true
  - name: last_refreshed
    type: date-time
    format: ISO 8601
  volume:
    hits_total: 2603
    observed: '2026-07-25'
- name: Firm
  api: FCA Financial Services Register API
  verified: false
  path: /services/V0.1/Firm/{FRN}
  key: Firm Reference Number (FRN)
  description: >-
    An authorised or previously authorised firm — including insurers, Lloyd's
    managing agents, MGAs, brokers and appointed representatives.
  sub_resources:
  - {path: '/Names', describes: trading and previous names}
  - {path: '/Individuals', describes: individuals attached to the firm}
  - {path: '/Permissions', describes: regulated activities the firm is permitted to carry on}
  - {path: '/Requirements', describes: requirements imposed on the permission}
  - {path: '/Requirements/{ref}/InvestmentTypes', describes: investment types under a requirement}
  - {path: '/Passports', describes: passported activity by country}
  - {path: '/Passports/{country}/Permission', describes: passported permissions in a country}
  - {path: '/Regulators', describes: current and previous regulators}
  - {path: '/AR', describes: appointed representatives of the firm}
  - {path: '/Address', describes: 'addresses; supports ?Type=PPOB and ?Type=Complaint'}
  - {path: '/Waivers', describes: waivers granted}
  - {path: '/Exclusions', describes: exclusions}
  - {path: '/DisciplinaryHistory', describes: disciplinary and enforcement history}
- name: Individual
  api: FCA Financial Services Register API
  verified: false
  path: /services/V0.1/Individuals/{IRN}
  key: Individual Reference Number (IRN)
  description: An approved or certified person on the Register.
  sub_resources:
  - {path: '/CF', describes: controlled functions held}
  - {path: '/DisciplinaryHistory', describes: disciplinary history}
- name: CollectiveInvestmentScheme
  api: FCA Financial Services Register API
  verified: false
  path: /services/V0.1/CIS/{PRN}
  key: Product Reference Number (PRN)
  description: A fund / collective investment scheme.
  sub_resources:
  - {path: '/Names', describes: scheme names}
  - {path: '/Subfund', describes: sub-funds of the scheme}
- name: SearchResult
  api: FCA Financial Services Register API
  verified: false
  path: /services/V0.1 common search
  description: >-
    Generic name search across firms, individuals and funds. Takes a name (or
    substring) and a resource type of firm | individual | fund, and returns rows
    carrying URL, Status, Reference Number, Type of business or Individual, Name.
relationships:
- from: Firm
  to: Individual
  kind: has_many
  via: /Firm/{FRN}/Individuals
- from: Firm
  to: Firm
  kind: has_many
  via: /Firm/{FRN}/AR
  note: >-
    principal → appointed representative. An AR may have more than one principal,
    so the graph is many-to-many; the API exposes it from the principal side.
- from: Individual
  to: Firm
  kind: belongs_to
  via: controlled functions held at a firm (/Individuals/{IRN}/CF)
- from: CollectiveInvestmentScheme
  to: CollectiveInvestmentScheme
  kind: has_many
  via: /CIS/{PRN}/Subfund
- from: SearchResult
  to: [Firm, Individual, CollectiveInvestmentScheme]
  kind: has_one
  via: the URL field, which is the absolute /services/V0.1 resource address
- from: FIRDSFile
  to: artefact
  kind: has_one
  via: download_link
- from: FITRSFile
  to: artefact
  kind: has_one
  via: download_link
id_prefixes:
- {entity: Firm, form: numeric FRN, examples: ['122702', '759676', '833790']}
- {entity: Individual, form: alphanumeric IRN, examples: [MXC29012, BXC00280, LAA01049]}
- {entity: CollectiveInvestmentScheme, form: numeric PRN, examples: ['635641', '185045']}