Filing History

Search…
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
Company Resources - Previous
Directorships
Next - Company Resources
Group Company
Last modified 2yr ago
Copy link
Contents