item_locations
Fetch item locations matching the supplied arguments.
Arguments
| Argument | Type | Required | Default | Description |
|---|---|---|---|---|
warehouse_id | String | No | Filter by public API warehouse ID. Use this ID field when selecting a warehouse; warehouse fields are display values or nested objects. | |
sku | [String] | No | Filter by SKU. SKU matching is case-insensitive and ignores surrounding whitespace. | |
customer_account_id | String | No | Filter by 3PL child/customer account ID; omit to use the authenticated account. | |
location_name | [String] | No | Filter by one or more location name values. | |
location_name_prefix | String | No | Filter by location name prefix. | |
has_inventory | Boolean | No | When true, filters results where has inventory applies; when false, filters where it does not. | |
location_type_id | [String] | No | Filter by location type ID; pass the public API ID unless the field name says legacy ID. | |
pickable | Boolean | No | When true, filters results where pickable applies; when false, filters where it does not. | |
sellable | Boolean | No | When true, filters results where sellable applies; when false, filters where it does not. | |
created_from | ISODateTime | No | Inclusive start of the created range, in ISO-8601 datetime format. | |
created_to | ISODateTime | No | Inclusive end of the created range, in ISO-8601 datetime format. | |
updated_from | ISODateTime | No | Inclusive start of the updated range, in ISO-8601 datetime format. | |
updated_to | ISODateTime | No | Inclusive end of the updated range, in ISO-8601 datetime format. | |
analyze | Boolean | No | If true, the query will only be analyzed (cost estimated) without executing it. |
Return Type
Query
query item_locations(
$warehouse_id: String,
$sku: [String],
$customer_account_id: String,
$location_name: [String],
$location_name_prefix: String,
$has_inventory: Boolean,
$location_type_id: [String],
$pickable: Boolean,
$sellable: Boolean,
$created_from: ISODateTime,
$created_to: ISODateTime,
$updated_from: ISODateTime,
$updated_to: ISODateTime,
$analyze: Boolean
) {
item_locations(
warehouse_id: $warehouse_id,
sku: $sku,
customer_account_id: $customer_account_id,
location_name: $location_name,
location_name_prefix: $location_name_prefix,
has_inventory: $has_inventory,
location_type_id: $location_type_id,
pickable: $pickable,
sellable: $sellable,
created_from: $created_from,
created_to: $created_to,
updated_from: $updated_from,
updated_to: $updated_to,
analyze: $analyze
) {
request_id
complexity
data {
pageInfo {
hasNextPage
hasPreviousPage
startCursor
endCursor
}
edges {
node {
id
legacy_id
account_id
warehouse_id
location_id
sku
quantity
loose_quantity
allocated_quantity
created_at
updated_at
location {
id
legacy_id
account_id
warehouse_id
type {
id
legacy_id
account_id
name
daily_storage_cost
category
is_lpn_allowed
}
name
zone
pickable
sellable
staging
is_cart
pick_priority
dimensions {
weight
height
width
length
}
length
width
height
max_weight
temperature
products {
pageInfo {
hasNextPage
hasPreviousPage
startCursor
endCursor
}
edges {
node {
id
legacy_id
account_id
name
sku
price
value
value_currency
barcode
country_of_manufacture
dimensions {
weight
height
width
length
}
tariff_code
kit
kit_build
no_air
final_sale
customs_value
customs_description
not_owned
dropship
needs_serial_number
thumbnail
large_thumbnail
created_at
updated_at
product_note
virtual
ignore_on_invoice
ignore_on_customs
active
needs_lot_tracking
is_assembly
packer_note
size
style
vendor_part_number
consumer_package_code
buyer_part_number
buyer_style_number
auto_pack
warehouse_products {
id
legacy_id
account_id
sku
warehouse_id
warehouse_identifier
price
value
value_currency
on_hand
inventory_bin
inventory_overstock_bin
reserve_inventory
replenishment_level
replenishment_max_level
replenishment_increment
reorder_amount
reorder_level
backorder
allocated
available
non_sellable_quantity
in_tote
custom
customs_value
created_at
updated_at
sell_ahead
active
warehouse {
...WarehouseFragment
}
product {
...ProductFragment
}
inbounds {
...WarehouseProductInboundConnectionFragment
}
locations {
...ItemLocationConnectionFragment
}
}
fba_inventory {
id
legacy_id
quantity
marketplace_id
merchant_id
}
images {
src
position
}
tags
vendors {
vendor_id
vendor_sku
price
}
components {
...ProductFragment
}
kit_components {
id
legacy_id
account_id
sku
quantity
}
assembly_components {
id
legacy_id
account_id
sku
quantity
}
cases {
id
legacy_id
case_barcode
case_quantity
}
}
cursor
}
}
last_counted
created_at
expiration_lots {
pageInfo {
hasNextPage
hasPreviousPage
startCursor
endCursor
}
edges {
node {
id
legacy_id
account_id
po_id
name
sku
created_at
updated_at
expires_at
received_at
is_active
locations {
pageInfo {
...PageInfoFragment
}
edges {
...LocationEdgeFragment
}
}
purchase_orders {
pageInfo {
...PageInfoFragment
}
edges {
...PurchaseOrderEdgeFragment
}
}
}
cursor
}
}
}
location_type {
id
legacy_id
account_id
name
daily_storage_cost
category
is_lpn_allowed
}
expiration_lot {
id
legacy_id
account_id
po_id
name
sku
created_at
updated_at
expires_at
received_at
is_active
locations {
pageInfo {
hasNextPage
hasPreviousPage
startCursor
endCursor
}
edges {
node {
id
legacy_id
account_id
warehouse_id
type {
id
legacy_id
account_id
name
daily_storage_cost
category
is_lpn_allowed
}
name
zone
pickable
sellable
staging
is_cart
pick_priority
dimensions {
weight
height
width
length
}
length
width
height
max_weight
temperature
products {
pageInfo {
...PageInfoFragment
}
edges {
...ProductEdgeFragment
}
}
last_counted
created_at
expiration_lots {
pageInfo {
...PageInfoFragment
}
edges {
...LotEdgeFragment
}
}
}
cursor
}
}
purchase_orders {
pageInfo {
hasNextPage
hasPreviousPage
startCursor
endCursor
}
edges {
node {
id
legacy_id
po_number
account_id
warehouse_id
vendor_id
created_at
po_date
date_closed
arrived_at
packing_note
fulfillment_status
po_note
description
partner_order_number
subtotal
discount
total_price
tax
shipping_method
shipping_carrier
shipping_name
shipping_price
tracking_number
pdf
images
payment_method
payment_due_by
payment_note
locking
locked_by_user_id
line_items {
pageInfo {
...PageInfoFragment
}
edges {
...PurchaseOrderLineItemEdgeFragment
}
}
attachments {
pageInfo {
...PageInfoFragment
}
edges {
...PurchaseOrderAttachmentEdgeFragment
}
}
vendor {
id
legacy_id
name
email
account_number
account_id
address {
...AddressFragment
}
currency
internal_note
default_po_note
logo
partner_vendor_id
created_at
}
warehouse {
id
legacy_id
account_id
identifier
dynamic_slotting
invoice_email
phone_number
profile
address {
...AddressFragment
}
return_address {
...AddressFragment
}
company_name
company_alias
active
products {
...ProductConnectionFragment
}
}
origin_of_shipment
tracking_numbers {
pageInfo {
...PageInfoFragment
}
edges {
...PurchaseOrderTrackingNumberEdgeFragment
}
}
ship_date
}
cursor
}
}
}
lpns {
pageInfo {
hasNextPage
hasPreviousPage
startCursor
endCursor
}
edges {
node {
container_type
status
lpn_id
sku
units
order {
id
legacy_id
order_number
partner_order_id
shop_name
fulfillment_status
order_date
total_tax
subtotal
total_discounts
total_price
box_name
ready_to_ship
auto_print_return_label
custom_invoice_url
account_id
updated_at
created_at
email
profile
gift_note
packing_note
required_ship_date
shipping_lines {
title
carrier
method
price
}
shipping_address {
first_name
last_name
company
address1
address2
city
state
state_code
zip
country
country_code
email
phone
}
billing_address {
first_name
last_name
company
address1
address2
city
state
state_code
zip
country
country_code
email
phone
}
tags
line_items {
pageInfo {
...PageInfoFragment
}
edges {
...LineItemQuerySpecEdgeFragment
}
total_count
}
authorizations {
transaction_id
authorized_amount
postauthed_amount
refunded_amount
card_type
date
}
holds {
fraud_hold
address_hold
shipping_method_hold
operator_hold
payment_hold
client_hold
}
shipments {
id
legacy_id
order_id
user_id
warehouse_id
pending_shipment_id
address {
...AddressFragment
}
profile
picked_up
needs_refund
refunded
delivered
shipped_off_shiphero
dropshipment
completed
created_date
line_items {
...ShipmentLineItemConnectionFragment
}
shipping_labels {
...ShippingLabelFragment
}
warehouse {
...WarehouseFragment
}
order {
...OrderFragment
}
total_packages
ready_to_ship
}
returns {
id
legacy_id
account_id
order_id
partner_id
reason
status
label_type
label_cost
labels {
...RMALabelTypeFragment
}
cost_to_customer
shipping_carrier
shipping_method
dimensions {
...DimensionsFragment
}
address {
...AddressFragment
}
line_items {
...ReturnLineItemFragment
}
total_items_expected
total_items_received
total_items_restocked
created_at
display_issue_refund
order {
...OrderFragment
}
exchanges {
...ReturnExchangeFragment
}
return_history {
...ReturnHistoryFragment
}
attachments {
...ReturnAttachmentFragment
}
}
rma_labels {
id
legacy_id
account_id
order_id
rma_id
shipment_id
shipping_name
tracking_number
status
carrier
shipping_method
cost
box_code
dimensions {
...DimensionsFragment
}
address {
...AddressFragment
}
paper_pdf_location
thermal_pdf_location
pdf_location
image_location
delivered
picked_up
refunded
needs_refund
profile
full_size_to_print
partner_fulfillment_id
created_at
updated_at
}
flagged
saturday_delivery
ignore_address_validation_errors
skip_address_validation
priority_flag
allocation_priority
allocations {
order_id
warehouse_id
allocated_at
allocation_reference
ready_to_ship
line_items {
...OrderLineItemAllocationFragment
}
is_locked
}
source
third_party_shipper {
account_number
zip
country
}
gift_invoice
allow_partial
require_signature
adult_signature_required
alcohol
expected_weight_in_oz
insurance
insurance_amount
currency
has_dry_ice
allow_split
hold_until_date
incoterms
tax_id
tax_type
dry_ice_weight_in_lbs
ftr_exemption
ftr_exemption_value
address_is_business
tote_qa
do_not_print_invoice
ignore_payment_capture_errors
service_point_id
partner_source_name
order_history {
id
legacy_id
order_id
user_id
account_id
username
order_number
information
created_at
order {
...OrderFragment
}
}
merged_orders {
order_id
is_master
}
attachments {
pageInfo {
...PageInfoFragment
}
edges {
...OrderAttachmentQuerySpecEdgeFragment
}
total_count
}
wholesale_order {
id
legacy_id
version
fulfillment_flow
shipping_option
staging_location_id
picking_flow
outbound_progress
pickup_date
status
status_message
preparation_date
is_packed_externally
packing_layout
order_type
gs1_labels_required
trading_partner_id
trading_partner_name
store_location_number
store_address1
store_city
store_country
store_state
store_zip
distribution_center
distribution_center_number
purchase_order_type
vendor
vendor_id
requested_delivery_date
ship_not_before_date
ship_no_later_than_date
depositor_order_number
department
department_number
division
service_level
internal_supplier_number
terms_of_sale
retailer_notes
quote_number
sales_requirement_code
reference_fields
order_id
order {
...OrderFragment
}
wholesale_shipping_details {
...WholesaleShippingDetailsFragment
}
wholesale_line_items {
...WholesaleLineItemsQuerySpecConnectionFragment
}
}
}
}
cursor
}
}
product {
id
legacy_id
account_id
name
sku
price
value
value_currency
barcode
country_of_manufacture
dimensions {
weight
height
width
length
}
tariff_code
kit
kit_build
no_air
final_sale
customs_value
customs_description
not_owned
dropship
needs_serial_number
thumbnail
large_thumbnail
created_at
updated_at
product_note
virtual
ignore_on_invoice
ignore_on_customs
active
needs_lot_tracking
is_assembly
packer_note
size
style
vendor_part_number
consumer_package_code
buyer_part_number
buyer_style_number
auto_pack
warehouse_products {
id
legacy_id
account_id
sku
warehouse_id
warehouse_identifier
price
value
value_currency
on_hand
inventory_bin
inventory_overstock_bin
reserve_inventory
replenishment_level
replenishment_max_level
replenishment_increment
reorder_amount
reorder_level
backorder
allocated
available
non_sellable_quantity
in_tote
custom
customs_value
created_at
updated_at
sell_ahead
active
warehouse {
id
legacy_id
account_id
identifier
dynamic_slotting
invoice_email
phone_number
profile
address {
name
address1
address2
city
state
country
zip
phone
}
return_address {
name
address1
address2
city
state
country
zip
phone
}
company_name
company_alias
active
products {
pageInfo {
hasNextPage
hasPreviousPage
startCursor
endCursor
}
edges {
node {
...ProductFragment
}
cursor
}
}
}
product {
...ProductFragment
}
inbounds {
pageInfo {
hasNextPage
hasPreviousPage
startCursor
endCursor
}
edges {
node {
id
legacy_id
sku
warehouse_id
po_id
purchase_order_line_item_id
po_date
quantity
quantity_received
quantity_rejected
sell_ahead
status
}
cursor
}
}
locations {
...ItemLocationConnectionFragment
}
}
fba_inventory {
id
legacy_id
quantity
marketplace_id
merchant_id
}
images {
src
position
}
tags
vendors {
vendor_id
vendor_sku
price
}
components {
...ProductFragment
}
kit_components {
id
legacy_id
account_id
sku
quantity
}
assembly_components {
id
legacy_id
account_id
sku
quantity
}
cases {
id
legacy_id
case_barcode
case_quantity
}
}
warehouse_product {
id
legacy_id
account_id
sku
warehouse_id
warehouse_identifier
price
value
value_currency
on_hand
inventory_bin
inventory_overstock_bin
reserve_inventory
replenishment_level
replenishment_max_level
replenishment_increment
reorder_amount
reorder_level
backorder
allocated
available
non_sellable_quantity
in_tote
custom
customs_value
created_at
updated_at
sell_ahead
active
warehouse {
id
legacy_id
account_id
identifier
dynamic_slotting
invoice_email
phone_number
profile
address {
name
address1
address2
city
state
country
zip
phone
}
return_address {
name
address1
address2
city
state
country
zip
phone
}
company_name
company_alias
active
products {
pageInfo {
hasNextPage
hasPreviousPage
startCursor
endCursor
}
edges {
node {
id
legacy_id
account_id
name
sku
price
value
value_currency
barcode
country_of_manufacture
dimensions {
...DimensionsFragment
}
tariff_code
kit
kit_build
no_air
final_sale
customs_value
customs_description
not_owned
dropship
needs_serial_number
thumbnail
large_thumbnail
created_at
updated_at
product_note
virtual
ignore_on_invoice
ignore_on_customs
active
needs_lot_tracking
is_assembly
packer_note
size
style
vendor_part_number
consumer_package_code
buyer_part_number
buyer_style_number
auto_pack
warehouse_products {
...WarehouseProductFragment
}
fba_inventory {
...FbaInventoryFragment
}
images {
...ProductImageFragment
}
tags
vendors {
...ProductVendorFragment
}
components {
...ProductFragment
}
kit_components {
...KitComponentFragment
}
assembly_components {
...AssemblyComponentFragment
}
cases {
...CaseFragment
}
}
cursor
}
}
}
product {
id
legacy_id
account_id
name
sku
price
value
value_currency
barcode
country_of_manufacture
dimensions {
weight
height
width
length
}
tariff_code
kit
kit_build
no_air
final_sale
customs_value
customs_description
not_owned
dropship
needs_serial_number
thumbnail
large_thumbnail
created_at
updated_at
product_note
virtual
ignore_on_invoice
ignore_on_customs
active
needs_lot_tracking
is_assembly
packer_note
size
style
vendor_part_number
consumer_package_code
buyer_part_number
buyer_style_number
auto_pack
warehouse_products {
...WarehouseProductFragment
}
fba_inventory {
id
legacy_id
quantity
marketplace_id
merchant_id
}
images {
src
position
}
tags
vendors {
vendor_id
vendor_sku
price
}
components {
...ProductFragment
}
kit_components {
id
legacy_id
account_id
sku
quantity
}
assembly_components {
id
legacy_id
account_id
sku
quantity
}
cases {
id
legacy_id
case_barcode
case_quantity
}
}
inbounds {
pageInfo {
hasNextPage
hasPreviousPage
startCursor
endCursor
}
edges {
node {
id
legacy_id
sku
warehouse_id
po_id
purchase_order_line_item_id
po_date
quantity
quantity_received
quantity_rejected
sell_ahead
status
}
cursor
}
}
locations {
...ItemLocationConnectionFragment
}
}
}
cursor
}
}
}
}Variables
{
"warehouse_id": "V2FyZWhvdXNlOjEyMzQ=",
"sku": ["BLUE-TEE-M", "RED-HOODIE-L"],
"customer_account_id": "QWNjb3VudDoxMjM0",
"location_name": ["A01-01-01", "B02-02-02"],
"location_name_prefix": "A01-01-01",
"has_inventory": true,
"location_type_id": ["TG9jYXRpb25UeXBlOjEyMzQ="],
"pickable": true,
"sellable": true,
"created_from": "2026-07-09T15:30:00Z",
"created_to": "2026-07-09T15:30:00Z",
"updated_from": "2026-07-09T15:30:00Z",
"updated_to": "2026-07-09T15:30:00Z",
"analyze": true
}Response
{
"data": {
"item_locations": {
"request_id": "UmVjb3JkOjEyMzQ=",
"complexity": 100,
"data": [{id: "TG9jYXRpb246MTIzNA==", name: "A01-01-01"}]
}
}
}