Where to find transaction_id required for Documents API?

[ian_havelock]

Hi,

As per the documentation for https://developer.companieshouse.gov.uk/api/docs/company/company_number/filing-history/transaction_id/getFilingHistoryItem.html, 2 pieces of information are required: the company number and the transaction_id. However, the documentation doesn’t mention anywhere that I can see, where this transaction id is to be found? Is it returned as part of some other endpoint?

Kind Regards,
Ian

[ash]

Check these:

Get the filing history of the company

filingHistoryList resource

It’s non-optional part of the item returned when you list a file history that acts as a unique identifier for that item.

[csmith]

We would recommend you use the document_metadata link returned by the filing history resource, instead of manipulating the API URL yourself. Every resource for a company should be discoverable from the company profile resource, however we are aware that some are missing due to an oversight early on in development. This is in the process of being corrected.

Please take a look at the following post, particularly my response (two or three replies in) for an explanation of the issues with URL manipulation:

Help with Document API & Fetch a Document

A note for step (2): A client should be following links.document_metadata URL of the filing history to get to a document, and not have to construct URL’s on the fly. Should we change the ID encoding, then client’s that construct their own URLs will break. So, in the short term, take the links.document_metadata URL from the filing history, and append /content onto the end. This will return the default PDF, but if PDF is not available, you’ll have to deal with the failure. Calling the document_m…

Regards
Chris