Locate nearby stores

This endpoint retrieves a paginated list of stores near a given location, with optional filters for site status and actual distance calculation.

Prerequisites

  • Authentication: Bearer JWT (cap_authorization)
  • Headers: cap_device_id, cap_brand, cap_mobile

Resource information

URI/store-locator/v1/brand/nearbystores
HTTP MethodGET
PaginationYes
Batch supportNo
Rate limit informationNot specified

Endpoint

GET https://crm-nightly-new.cc.capillarytech.com/store-locator/v1/brand/nearbystores

Request Headers

HeaderDescription
Content-TypeMust be application/json
cap_authorizationBearer JWT token for authentication
cap_device_idUnique identifier for the device
cap_brandBrand identifier
cap_mobileMobile identifier of the user or device

Request query parameters

NameTypeDescription
pageintegerZero-based page index to retrieve (default 0)
sizeintegerNumber of items per page (default 10)
actualDistancebooleanIf true, calculates and returns the actual distances
site_statusstringFilter by store status (e.g., Active, Inactive)
latitudenumberLatitude of the reference location (e.g., 10.817141)
longitudenumberLongitude of the reference location (e.g., 106.707954)
distanceintegerMaximum distance in meters to search (e.g., 500000)

Request Body

curl -i -X GET \
  -H "cap_authorization: eyJpZHYiOlsiTU9CSUxFfDk1OTEzOTkyNDQiXSwiZGV2IjoiMTIzIiwib3JnIjoiS1JJU0hOQVNNQUxMIiwiYWxnIjoiSFMyNTYifQ.eyJpc3MiOiJDQVBJTElhUlkgVEVDSE5PTE9HSUVTIiwib2djIjpbIjUwNTgzfGtyaXNobmEudGlsbDAxIl0sImV4cCI6MTY2NDI2NjQ2OSwiaWF0IjoxNjY0MjYyODY5LCJyb2wiOiJWSUVXIn0.6ZFThZOZ6jQZ4JT-sG3DkiCBfiIxR07kjjqOYr-BJHQ" \
  -H "cap_device_id: deviceId" \
  -H "cap_brand: brand" \
  -H "cap_mobile: identifierValue" \
  -H "Content-Type: application/json" \
  "[https://crm-nightly-new.cc.capillarytech.com/store-locator/v1/brand/nearbystores?page=0&actualDistance=true&site_status=Active&latitude=10.817141&longitude=106.707954&distance=500000&size=10](https://crm-nightly-new.cc.capillarytech.com/store-locator/v1/brand/nearbystores?page=0&actualDistance=true&site_status=Active&latitude=10.817141&longitude=106.707954&distance=500000&size=10)"
Language
Click Try It! to start a request and see the response here!