Our code currently relies on the premises field to parse addresses, however we have noticed that the docs have been updated and there is no longer any reference to premises and API results have stopped returning it, after searching this forum I couldn’t find any reference to this being deprecated.
Do you have any information on this?
Which docs do you mean when you say the docs have been updated?
Premises is still there in the API documentation (eg: https://developer.companieshouse.gov.uk/api/docs/company/company_number/registered-office-address/registeredOfficeAddress-resource.html). It’s optional though (even if it doesn’t say it is on this page) so I’m guessing it only shows up in the results if it’s there.
I was looking here https://developer.companieshouse.gov.uk/api/docs/search-overview/CompanySearch-resource.html
However as you say on that page that you linked, it says it is not optional but results from that endpoint definitely come back with the premises field being empty (e.g. 10590453)
Thanks for clarifying. Could the docs be updated?
Cheers,
Brendan
Interestingly if you try 04301762 (Test Limited!) it comes up with… a premises when you do a CompanySearch call, but doesn’t when you do a CompanyProfile call or RegisteredOffice call.
I had a poke around on a company we’ve formed and based on that it looks like the CompanySearch returns exactly what we sent through (via XML) on incorporation, which included an (optional) premise tag, but the CompanyProfile has moved Premise and Street to Address1 and Address2 in the api, so there must be some form of conversion going on between the two systems. Based on this I’d be wary of using CompanySearch to process addresses.
Just a heads up that I’m just a user of the APIl… I’d like to see the documentation updated as well!