# Filing history change - documents api alias?

**URL:** <http://forum.companieshouse.gov.uk/t/filing-history-change-documents-api-alias/1813>\
**Category:** Uncategorized\
**Created:** [May 14, 2018, 9:37am UTC](http://forum.companieshouse.gov.uk/t/filing-history-change-documents-api-alias/1813 "2018-05-14T09:37:57Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![voracityemail](http://forum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/v/b77776/32.png) [@voracityemail](http://forum.companieshouse.gov.uk/u/voracityemail)\
**Post date:** [May 14, 2018, 9:37am UTC](http://forum.companieshouse.gov.uk/t/filing-history-change-documents-api-alias/1813/1 "2018-05-14T09:37:57Z")

</div>

Has an alias been created for the Documents API? As of this weekend, when we request the filing history list we see the links to the document metatdata reported as:

```
https://frontend-doc-api.companieshouse.gov.uk/document/...

```

rather than

```
https://document-api.companieshouse.gov.uk/document/...

```

Either URL works correctly (and so does downloading the documents), so that’s OK, but our concern was that this change wasn’t announced and we did assume that the address part of the API - essentially the endpoint - wouldn’t change without notice.

Example filing history resource:  
For: [/company/OC301540/filing-history](https://beta.companieshouse.gov.uk/company/OC301540/filing-history)  
{  
“items”: [  
{  
“type”: “LLAP01”,  
“links”: {  
“self”: “/company/OC301540/filing-history/MzIwNDIwNTYyN2FkaXF6a2N4”,  
“document\_metadata”: “\*\*[https://frontend-doc-api.companieshouse.gov.uk/\*\*document/0dqXQ1WLToNiuaUur7-1hMK5WX5ngcsNHIMna0hkjXA](https://frontend-doc-api.companieshouse.gov.uk/**document/0dqXQ1WLToNiuaUur7-1hMK5WX5ngcsNHIMna0hkjXA)”  
},  
…  
},  
…  
}

Example document metadata for /document/0dqXQ1WLToNiuaUur7-1hMK5WX5ngcsNHIMna0hkjXA  
{  
“links”: {  
“self”: “**[https://document-api.companieshouse.gov.uk](https://document-api.companieshouse.gov.uk)**/document/0dqXQ1WLToNiuaUur7-1hMK5WX5ngcsNHIMna0hkjXA”,  
“document”: “**[https://document-api.companieshouse.gov.uk/document](https://document-api.companieshouse.gov.uk/document)**/0dqXQ1WLToNiuaUur7-1hMK5WX5ngcsNHIMna0hkjXA/content”  
},  
“company\_number”: “OC301540”,  
“barcode”: “X757C08O”,  
“significant\_date”: null,  
“significant\_date\_type”: “”,  
“category”: “miscellaneous”,  
“pages”: 2,  
“created\_at”: “2018-05-09T10:21:30.185332602Z”,  
“etag”: “”,  
“resources”: {  
“application/pdf”: {  
“content\_length”: 16625  
}  
}  
}

---

<div class="post-metadata">

**Author:** ![MArkWilliams](http://forum.companieshouse.gov.uk/user_avatar/forum.companieshouse.gov.uk/markwilliams/32/194_2.png) [@MArkWilliams](http://forum.companieshouse.gov.uk/u/MArkWilliams)\
**Post date:** [May 14, 2018, 10:44am UTC](http://forum.companieshouse.gov.uk/t/filing-history-change-documents-api-alias/1813/2 "2018-05-14T10:44:31Z")

</div>

These endpoints can change at any time, and along with many other system changes, will not be announced.