Filing History
This endpoint links to Companies House, allowing you to view and retrieve documents in PDF format.

Retrieving Documents

In order to retrieve a document as a PDF from the filing history results, you should query the document link (relationships > document > links > related) but you must change the MIME Type in the header to application/pdf.

Example URL:

1
https://api2.redflagalert.net/v4/companies/01777777/filing-history/
Copied!

JSON Structure:

1
{
2
"data": [{
3
"relationships": {
4
"document": {
5
"links": {
6
"related": "https://api2.redflagalert.net/v4/documents/wW054GFYFWfdZYMIyIfTDank2njJSKJb35KaxwY9AeA/"
7
}
8
}
9
},
10
"attributes": {
11
"category": "mortgage",
12
"description": "mortgage-create-with-deed-with-charge-number",
13
"links": {
14
"self": "/company/01777777/filing-history/MzA5MTY0OTM4M2FkaXF6a2N4"
15
},
16
"barcode": "A2NMAXXV",
17
"text_description": "Registration of a charge",
18
"paper_filed": true,
19
"description_values": {
20
"charge_number": "017777770771"
21
},
22
"date": "2013-12-20",
23
"type": "MR01",
24
"pages": 6,
25
"document_id": "wW054GFYFWfdZYMIyIfTDank2njJSKJb35KaxwY9AeA",
26
"subcategory": "create"
27
},
28
"type": "filing_history",
29
"id": "MzA5MTY0OTM4M2FkaXF6a2N4-A2NMAXXV",
30
"links": {
31
"self": "https://api2.redflagalert.net/v4/companies/01777777/filing-history/MzA5MTY0OTM4M2FkaXF6a2N4"
32
}
33
}],
34
"links": {
35
"self": "https://api2.redflagalert.net/v4/companies/01777777/filing-history/",
36
"next": "https://api2.redflagalert.net/v4/companies/01777777/filing-history/?page%5Boffset%5D=2",
37
"last": "https://api2.redflagalert.net/v4/companies/01777777/filing-history/?page%5Boffset%5D=32",
38
"first": "https://api2.redflagalert.net/v4/companies/01777777/filing-history/?page%5Boffset%5D=1"
39
}
40
}
Copied!

Attributes

Field Key
Description
Notes
category
The category of the document filed.
Possible values are:
accounts
address
annual-return
capital
change-of-name
incorporation
liquidation
miscellaneous
mortgage
officers
resolution
description
A description of the filing.
For enumeration descriptions see description section in the enumeration mappings.​
links
Links to other resources associated with this filing history item.
​
barcode
The barcode of the document.
​
text_description
A text description of the filing.
For enumeration descriptions see description section in the enumeration mappings.​
paper_filed
If true, indicates this is a paper filing.
​
description_values
The main description code
​
date
The date the associated filing was processed.
​
type
The type of the associated filing.
​
pages
Number of pages within the PDF document (links.document_metadata)
​
document_id
The document id of the resolution.
​
subcategory
The sub-category of the document filed.
Possible values are:
resolution
Last modified 2yr ago