📌
Red Flag A!ert
  • API Introduction
  • Authentication
  • Format & Pagination
  • Company
    • Company
    • Other Resources
    • Including additional resources
    • Attributes
    • Search
  • Company Resources
    • Addresses
    • Balance Sheet
    • Cashflow
    • Contacts
    • CCJs
    • Directorships
    • Filing History
    • Group Company
    • Mortgages
    • Parent Company
    • Previous Names
    • Profit & Loss
    • Ratio Analysis
    • Shareholders
    • Unpaid Debt
    • Unpaid Losses
  • Directors
    • Directorship
    • Attributes
    • Search
  • AML
    • Introduction
    • ID & AML Check
    • Charges
    • Search
    • Example Request
    • Response
  • Appendix
    • 1: Dissolution Status Codes
    • 2: SIC Sections
    • 3: RFA Health Ratings
Powered by GitBook
On this page
  • Format/ Pagination
  • MIME Types
  • Generating PDF Responses
  • Browsable API

Was this helpful?

Format & Pagination

PreviousAuthenticationNextCompany

Last updated 5 years ago

Was this helpful?

Format/ Pagination

The Red Flag Alert API follows the JSON API () format and uses the REST architectural style with JSON throughout.

All responses will be returned as JSON, with the requested data being returned in the 'data' key of the response.

When performing a search, pagination links will be available as per the JSONAPI standard in a field called 'links', with 'first', 'previous', 'next' and 'last' links allowing navigation.

MIME Types

JSON API has been properly registered with the IANA. Its media type designation is .

Generating PDF Responses

In addition to the standard JSON response, companies can be requested formatted as PDF documents. In order to request this, change the 'Accept' header of your request to 'application/pdf'. Currently, this is only supported by the company/ endpoint.

The PDF document will also include any extra resources requested in the '?include=' GET parameter and therefore can be used to construct a full company report by appending '?include=all' to the URL (See 'Including Additional Resources').

Browsable API

To assist developers, a browsable API is available enabling the viewing and navigation of records in the browser. This can be accessed by visiting the corresponding URL in a browser; the API will detect that a browser is being used and displays records accordingly. A username and password will be requested; this is simply the API key and secret.

http://jsonapi.org
application/vnd.api+json