Hi, Can you tell me if the document_metadata uri’s in the filing history are static? So If I stored them on my system I would be able to retrieve the document at a later date.
Cheers, Stuart
All of the uri’s supplied by our API are designed to be static. We’re in beta so can’t say that uri’s will not change, but highly unlikely.
The metadata URI will get you a document url, which you can use to request access to the document itself, however the URL you finally get is time limited and cannot be stored or cached. To re-request a document, re-issue the document URL.
Can you say long the URLs will persist for? We’re intending queuing these for later pickup (possibly very quickly after, possibly a fair bit later if the queue gets processed slowly)
The document metadata and resource links ( https://document-api.companieshouse.gov.uk/document/{document-id} and https://document-api.companieshouse.gov.uk/document/{document-id}/content ) are permanent URLs and should remain valid.
The redirect URL you get back from the /content endpoint will be valid for 1 minute. Accessing the URL after that time will return a 403 Access Denied error with the message Request has expired, at which point you’d need to request a new URL from the Document API.