Get User Locations
The Get User Locations API retrieves information about the location(s) that a user is associated with. This call effectively acts like a Search API, returning a list of location results based on the userID criteria provided in the endpoint.
Version | 2.0 |
Call | https://integration.shopatron.com/api/usermgmt/v1/user/{userID}/location |
Supported Formats | JSON |
HTTP Method | GET |
Schema | https://integration.shopatron.com/api/v2/schema/location.json |
Note that the core URL may be different from the standard production environment, depending on the configuration.
The .json address above can be used to access the schema within Postman. An example use of the User Management API follows below, or view the sample Postman collection.
Example
In this example, the user location details included these particular properties:
- User ID 00000
- Has one location assigned (Location ID 5)
General Information
The response returns the following information about a user’s locations:
- Identification (Location, Store, Retailer, and Fulfiller IDs)
- Address and Contact Information (address, phone, fax, email)
- Configuration Details (active status, enabled featured, last updated)
The Full Request
This is the full request that would filter results that belong to a particular retailer or manufacturer.
https://integration.shopatron.com/api/usermgmt/v1/user/00000/location/
The Full Response
This is the full response returned by the API.
{
"collection": [
{
"locationID": 5,
"externalStoreID": "Ext ID 4",
"retailerID": 11111,
"fulfillerID": 10101,
"name": "Example Store",
"addressLine1": "111 Test St",
"addressLine2": "",
"addressLine3": "",
"city": "Dallas",
"state": "TX",
"countryCode": "US",
"postalCode": "75201",
"latitude": 43.6633,
"longitude": -70.1908,
"contact": " ",
"contactPhone": "000.111.2222",
"phone": "001112222",
"fax": "",
"email": "example@shopatron.com",
"localSalesTax": 0,
"active": true,
"shippingLocation": true,
"restockEnabled": false,
"pickupEnabled": false,
"showInAggregateReport": true,
"taxableLocation": false,
"mainLocation": false,
"lastUpdated": "2016-04-26T23:51:04+0000"
}
]
}