# FCA Data in UK Company Reports

This document describes how FCA (Financial Conduct Authority) properties are returned in UK company reports, specifically within the `additionalInformation` property of the API response. The FCA data can be found in two places:

- As direct properties under `miscellaneous`
- As objects within the `fcaData` array


## Location in the API Response

The FCA-related data appears in the following structure:


```json
{
  "additionalInformation": {
    "miscellaneous": {
      "fcaReferenceNumber": "string", // FCA registration number for the company
      "fcaAuthorisationStatus": "string" // Authorisation status (see below for possible values)
      // ...other properties
    },
    "fcaData": [
      {
        "fcaReferenceNumber": "string", // FCA registration number for the company
        "fcaAuthorisationStatus": "string" // Authorisation status (see below for possible values)
      }
      // ...additional FCA records if present
    ]
    // ...other properties
  }
}
```

## Property Descriptions

### `fcaReferenceNumber` (string)

- The unique reference number assigned to the company by the FCA.
- Example: `123456`


### `fcaAuthorisationStatus` (string)

- The current authorisation status of the company with the FCA.
- Example values may include:
  - `Authorised`
  - `Registered`
  - `No longer authorised`
  - `Application pending`
- **Note:** The API does not currently specify an enum for this property, but typical values are as above.


### `fcaData` (array)

- Contains one or more objects, each representing an FCA record for the company.
- Each object includes `fcaReferenceNumber` and `fcaAuthorisationStatus`.


## Example Response Snippet


```json
{
  "additionalInformation": {
    "miscellaneous": {
      "fcaReferenceNumber": "123456",
      "fcaAuthorisationStatus": "Authorised"
    },
    "fcaData": [
      {
        "fcaReferenceNumber": "123456",
        "fcaAuthorisationStatus": "Authorised"
      }
    ]
  }
}
```

## Where to Find FCA Data

- **Path:** `additionalInformation.miscellaneous.fcaReferenceNumber` and `additionalInformation.miscellaneous.fcaAuthorisationStatus`
- **Path:** `additionalInformation.fcaData[]` (array of FCA records)


## Notes

- The FCA properties may not be present for all companies; they are included only when relevant FCA data is available.
- If you require a definitive list of possible `fcaAuthorisationStatus` values.