- Support
- Product Releases
- Blog
- Overview
- API References
- API Authentication
- Getting Started with fabric APIs
- Making your first API request
- Example
- Using Developer Portal
- Security and Compliance
- Product Catalog API - Overview
- Developer Guide
Attributes & Attribute Mapping
Categories
Products
Collections
Background Jobs
Bulk Import & Export
Published Products
Allocations
- Orders (3.0.0)
Backorders Preorders
Exports
Developer Guide
Invoices
Shopping Lists
Shopping List Items
Notifications
Orders
Returns
Cancellations
Tracking
Frauds
Payments
Appeasements
Credits
Shipments
Shipping Methods
Shipping Method Items
Webhooks
- Orders FAQ(s)
- Overview
- Algolia standard integration
- Avalara standard integration
- Constructor.io standard integration
- Stripe standard integration
- Offers (3.0.0)
Real-time Pricing Engine
Promotions
Webhook Events
Redemptions
Priced Products
Product Exclusion Lists
Price Types
Coupons
Coupon Codes
Segments
Prices
Price Methods
Price Controls
Price Lists
Add-ons
Exports
Imports
Attributes
Customer Profile
Customer Address
Customer Self
Getting Started
Product Catalog
Orders
Integrations
Offers
Customers
Get locations by query
Get a list of locations by specified filter criteria.
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Merchant's 24-character tenant ID
Sales channel ID
Unique request ID
Number of records to skip before returning all records. Default is 0
when no value is specified.
Maximum number of records per page
Sample request to search locations
Property by which data is sorted. Note: -
refers to descending and +
refers to ascending order.
curl --request POST \
--url https://api.fabric.inc/v3/locations/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-fabric-channel-id: <x-fabric-channel-id>' \
--header 'x-fabric-tenant-id: <x-fabric-tenant-id>' \
--data '{
"sort": "-location.createdAt",
"filters": [
{
"field": "location.locationNum",
"value": "11245",
"condition": "EQ"
},
{
"field": "location.type",
"values": [
"DC",
"STORE"
],
"condition": "IN"
}
]
}'
{
"pagination": {
"limit": 10,
"offset": 1,
"count": 1000
},
"data": [
{
"locationId": "9372919a8219e8",
"locationNumber": 23,
"name": "Seattle Store",
"isActive": true,
"address": {
"addressLine1": "123 Main St.",
"addressLine2": "Suite 100",
"addressLine3": "Seventh floor",
"addressLine4": "Attention: Pat E. Kake",
"city": "Seattle",
"region": "WA",
"postalCode": "98121",
"countryCode": "US",
"type": "Home",
"contacts": [
{
"type": "OFFICE",
"email": "abc@mail.com",
"phone": [
{
"number": "0281923712",
"type": "MOBILE"
}
],
"name": {
"firstName": "Pat",
"middleName": "E",
"lastName": "Kake"
}
}
]
},
"type": "DC",
"createdAt": "2022-05-25T07:58:30.996Z",
"updatedAt": "2022-05-25T07:58:30.996Z",
"operatingHours": [
{
"day": "SUNDAY",
"hours": [
{
"open": "10",
"close": "20",
"type": "PICK_UP"
}
]
}
],
"coordinates": {
"type": "Point",
"coordinates": [
-122.3493,
47.6205
]
}
}
]
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Headers
Merchant's 24-character tenant ID
Sales channel ID
Unique request ID
Query Parameters
Number of records to skip before returning all records. Default is 0
when no value is specified.
Maximum number of records per page
Body
Property by which data is sorted. Note: -
refers to descending and +
refers to ascending order.
Field name
Filter conditions. <br /> EQ (Equal to): Searches for exact match. <br /> NEQ (Not equal to): Searches by excluding the specified value. <br /> IN: Search for multiple values. <br /> NIN (Not IN): Excludes the specified values in the search. LT (Less than): Searches for values that are less than the specified value. GT (Greater than): Search for values that are greater than the specified value. LTE (Less than or equal to): Searches for values that are less than or equal to the specified value. GTE (Greater than or equal to): Searches for values that are greater than or equal to the specified value.
EQ
, NEQ
, IN
, NIN
, LT
, GT
, LTE
, GTE
A single value for field
using which data is searched
Response
Pagination response
Maximum number of records per page
Number of records to skip before returning all records. For example, offset=20, limit=10
returns records 21-30.
Total number of search results
System-generated unique ID to identify the location
Merchant-specified unique number to identify the location
Location name
true: Location is active for order fulfillment operation.<br />false: Location is inactive.
Address details
Address line 1
Address line 2
Address line 3
Address line 4
City name
Region or state
Postal or ZIP code
ISO 3166-1 alpha-2 based country code
Address type
Contact details
Contact type
E-mail address
Phone number
Phone number
Phone type
Contact person's name for the location
First name
Middle name or initial
Last name
Location type
Time location was created
Time location was last updated
Location operating hours
Day of week
SUNDAY
, MONDAY
, TUESDAY
, WEDNESDAY
, THURSDAY
, FRIDAY
, SATURDAY
Store operating hour
Store opening time, measured in 24-hour format
Closing time for given hour type
Type of location operation
Location coordinates
Geo coordinate type
The location coordinates consist of a coordinate field in the format of [longitude, latitude], where the longitude value must fall between -180 and 180, and the latitude value must be between -90 and 90, both inclusive.
Was this page helpful?
curl --request POST \
--url https://api.fabric.inc/v3/locations/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-fabric-channel-id: <x-fabric-channel-id>' \
--header 'x-fabric-tenant-id: <x-fabric-tenant-id>' \
--data '{
"sort": "-location.createdAt",
"filters": [
{
"field": "location.locationNum",
"value": "11245",
"condition": "EQ"
},
{
"field": "location.type",
"values": [
"DC",
"STORE"
],
"condition": "IN"
}
]
}'
{
"pagination": {
"limit": 10,
"offset": 1,
"count": 1000
},
"data": [
{
"locationId": "9372919a8219e8",
"locationNumber": 23,
"name": "Seattle Store",
"isActive": true,
"address": {
"addressLine1": "123 Main St.",
"addressLine2": "Suite 100",
"addressLine3": "Seventh floor",
"addressLine4": "Attention: Pat E. Kake",
"city": "Seattle",
"region": "WA",
"postalCode": "98121",
"countryCode": "US",
"type": "Home",
"contacts": [
{
"type": "OFFICE",
"email": "abc@mail.com",
"phone": [
{
"number": "0281923712",
"type": "MOBILE"
}
],
"name": {
"firstName": "Pat",
"middleName": "E",
"lastName": "Kake"
}
}
]
},
"type": "DC",
"createdAt": "2022-05-25T07:58:30.996Z",
"updatedAt": "2022-05-25T07:58:30.996Z",
"operatingHours": [
{
"day": "SUNDAY",
"hours": [
{
"open": "10",
"close": "20",
"type": "PICK_UP"
}
]
}
],
"coordinates": {
"type": "Point",
"coordinates": [
-122.3493,
47.6205
]
}
}
]
}