How can I get a list of open cities?

Q&A
1

Hi,
Is there a way to collect via API list of open cities? I have a issue with city address.

We have given address (provided by user in form)

"delivery_address": {
	"street_line_1": "56A Rue Mazarine",
	"post_code": "75006",
	"city": "asdasd",
	"country": "France"
}

Where as you can see city is random string. Validate drop off address returning success true (assuming by postcode). But then when I’m trying to get open slots for city I’m providing asdasd because this city is provided by user. Slots of course not exists. Maybe it’s good idea to return on address validation some recognized meta about city/other info? Not just success: true.

I need cities list to collect them and put into the form as input select.
There is some other way to handle this problem?

2

Hello @mark,

We appreciate your feedback and agree with you that additional address response information would be valuable for this endpoint. We are considering this for the next version of our API that is currently being worked on.

You can find a list of our open cities here in our API documentation. Your idea to use these cities for validation of customer city input sounds like a great way to solve the problem you’re facing.

3

No problem, thanks for reply. I saw cities list, for the moment I did in our api hardcoded list with cities. Right now this solve our issue, but I will wait for any improvement on your side. Thanks!

1 Like
4

Hi Lauren,
the list for open cities is not accurate to reality. Simply test a city in your API using the “Get coverage” WS and the results will be not the same, for France.
In the best case, you could obtain a result around noon and evening, but the morning and afternoon, you simply get a “no results” (404)
Could you check your list, because we had to delete 15 cities in France in our offer. You can imagien the problem to our service.

5

Hi @OliviaMMCM,

Were you testing get zone coverage in Sandbox? We have identified that there are discrepancies between the zones available in our Sandbox and Production environments which is likely the reason that you see ‘NOT_FOUND’ errors for some of the listed zones when fetching their zone coverage in Sandbox.

We are working to ensure that there are no such differences between our Sandbox and Production environments and thus expect this issue to be resolves soon. The open cities list should however be up to date based on our Production environment, but do let us know if you’ve experienced otherwise.

6

Hi Lauren,

I’m testing directly you API endpoints in production. And many cities don’t respond with a cover zone.
juste check it: https://stuart.api-docs.io/v2/addresses/get-zone-coverage

7

Hi @OliviaMMCM,

If I check in the API docs through the link you send the responses here are using our Sandbox environment. If it’s Production where you’re finding this issue however, could you provide me with a couple of examples of cities which don’t respond with a cover zone? I am struggling to find any myself, thank you for your help in troubleshooting the issue.

8

Hi Lauren,
OK, we’re checking directly on production API with Postman this morning. I’ll let you know our results.

9

Hi Laureen,
Here are our results in production:
Charlevilles Mezières: KO = NOT FOUND
Aubagne: KO = we’re geolocate "Rians
{
“type”: “FeatureCollection”,
“features”: [
{
“type”: “Feature”,
“properties”: {
“name”: “aubagne - pu area”,
“zipcode”: “aubagne - pu area”
},
“geometry”: {
“coordinates”: [
[
[
5.78099,
43.583832
],
[
5.764774,
43.622744
],
[
5.717024,
43.607989
],
[
5.78099,
43.583832
]
]
],
“type”: “Polygon”
},
“id”: “06712e5c23881ed24671ac0090f61c58”
}
]
}

10

Hello Olivia,

I am able to fetch the zone for charleville_mezieres (see our list of Open cities), please make sure the name is formatted exactly as it is in the list (with underscore) for your request.

Screenshot 2020-09-25 at 18.12.50
Screenshot 2020-09-25 at 18.12.501726×1444 416 KB

For Aubagne it is now included in the marseille zone, I am updating the list to reflect this change.
Best Regards

11

Hi Paul, thanks for the good news. I update our list for our clients right away.
Best regards