Financial documents access - API - sometime it comes back with XBLR sometimes PDF

[deepak.roy]

Financial documents access - API - sometime it comes back with XBLR format sometimes PDF?

[voracityemail]

How are you requesting this? What URL? What “Accept” http header are you sending, if any? Are you using a live application or the test / sandbox?

See the posts on this thread relating to how to find out what data formats are available for a given filing, and how to then request the one you want.

[Solved] XBRL insead of PDF documents

You’ve said what you need! The solution is to ask for what you want by setting the Accept header when requesting the document content. Currently filings may be available in: No data at all - you might see some variant of “unavailable” or “please contact us for this”. PDF - the “standard”. XBRL - only a few and these are - as far as I’m aware - only when the company has filed in this format. CH don’t generate this info. …so you got lucky a few times. To see what’s available (per the docume…

[deepak.roy]

const url = https://document-api.company-information.service.gov.uk/document/${documentId}/content;
console.log(📥 Attempt ${attempt}: Fetching document from, url);

const response = await axios.get(url, {
  headers: {
    Authorization: `Basic ${Buffer.from(`${API_KEY}:`).toString("base64")}`,
  },
  responseType: "arraybuffer",
}); Live access

[voracityemail]

So - per the thread I quoted above, you just need to ensure that the appropriate http Accept header is sent e.g. if you want PDF then:

Accept: application/pdf

If you follow through the process in the thread I’ve linked you’ll see that the mime types of the data available are listed in the document metadata for a filing. I think generally almost everything is available as a PDF, and some documents may be available also in xBRL - but it would be sensible to check first (or at least - I think Companies House process expects people will do so - you could of course take the “I’m feeling lucky” approach and just see what you get, if anything…)