Get a list of authorized stores that have the UPC(s) in-stock.

Example request for brand with company ID 31 and upc 686487456105:

curl --request GET \
  --url https://www.locally.com/api/v2/brand/31/upc/686487456105/stores \
  --header 'Locally-Api-Token: <API_TOKEN>'

The request will return a list of 10 results. Your request can include multiple UPCs.

Example request for brand with company ID 31 and UPC 686487456105 or 686487456020:

curl --request GET \
  --url https://www.locally.com/api/v2/brand/31/upc/686487456105|686487456020/stores \
  --header 'Locally-Api-Token: <API_TOKEN>'

The request will return a list of 10 results with stores that have at least one of the UPCs in stock. To fetch the next page, you can specify an offset parameter.

Example request for fetching results 10 - 20 of brand company ID 31, UPC 686487456105 or 686487456020:

curl --request GET \
  --url https://www.locally.com/api/v2/brand/31/upc/686487456105|686487456020/stores?offset=10 \
  --header 'Locally-Api-Token: <API_TOKEN>'

The request will return results 10 to 20. To request more than 10 results at a time, you can specify the limit parameter. You can also combine the two parameters as desired.

Sample, abbreviated payload:

{
	"total": 2514,
	"offset": 0,
	"results": [
		{
			"zip": "38104",
			"store_id": 491,
			"country": "US",
			"address": "1710 Union Ave",
			"company_id": 31,
			"lng": "-90.00445147",
			"city": "Memphis",
			"rating": "",
			"brand_slug": "arcteryx",
			"phone": "(901) 722-8988",
			"company_name": "Outdoors Inc",
			"name": "Outdoors Inc | Curbside Pickup + Delivery Available",
			"state": "TN",
			"categories": "",
			"brand_bw_logo": "ArcteryxLogo_2015-09-16-15-_2017-04-01-12-46-28.jpg",
			"lat": "35.13585576",
			"in_stock_upcs": [
				{
					"upc": "686487456105",
					"product_id": "548303",
					"product_url": "https:\/\/www.locally.com\/sapi\/l\/31\/491\/548303"
				}
			],
			"is_hold_capable": 0,
			"is_dropship_capable": 0,
			"is_delivery_capable": null,
			"is_charge_capable": 0,
			"slug": "",
			"store_url": "https:\/\/www.locally.com\/sapi\/s\/31\/491"
		},
...
Language
Click Try It! to start a request and see the response here!