Warehouse Endpoints

List Warehouse Inventory

Retrieve inventory stored in your warehouses.

GET /warehouse/list

Query Parameters:

Parameter	Type	Required	Description
per_page	integer	Yes	Results per page. Allowed: 20, 50, 100, 250, 500, 1000, 2000
page	integer	No	Page number for pagination

Plus an account selection parameter.

Example Request:

curl -X GET "https://app.sellerlegend.com/api/warehouse/list?account_title=My Store US&per_page=100" \
  -H "Authorization: Bearer {ACCESS_TOKEN}"

Response:

{
  "current_page": 1,
  "total": 35,
  "per_page": 100,
  "last_page": 1,
  "data": [
    {
      "sku": "MY-SKU-001",
      "warehouse_name": "Main Warehouse",
      "quantity": 500,
      "location": "Aisle 3, Shelf B",
      "status": "available",
      "last_updated": "2025-01-15T10:00:00Z"
    }
  ]
}

Response Fields:

Field	Type	Description
sku	string	Seller SKU
warehouse_name	string	Name of the warehouse
quantity	integer	Current stock quantity
location	string	Storage location within the warehouse
status	string	Stock status (e.g., available, reserved)
last_updated	string	ISO 8601 timestamp of last update

Python SDK:

from sellerlegend_api import SellerLegendClient

client = SellerLegendClient(access_token="YOUR_ACCESS_TOKEN")

warehouse_inventory = client.warehouse.list(
    account_title="My Store US",
    per_page=500
)

for item in warehouse_inventory['data']:
    print(f"SKU: {item['sku']} | Warehouse: {item['warehouse_name']} | Qty: {item['quantity']}")

---

Get Inbound Shipments

Retrieve inbound shipments to Amazon fulfillment centers.

GET /warehouse/inbound-shipments

Query Parameters:

Parameter	Type	Required	Description
per_page	integer	Yes	Results per page. Allowed: 20, 50, 100, 250, 500, 1000, 2000
page	integer	No	Page number for pagination

Plus an account selection parameter.

Example Request:

curl -X GET "https://app.sellerlegend.com/api/warehouse/inbound-shipments?account_title=My Store US&per_page=50" \
  -H "Authorization: Bearer {ACCESS_TOKEN}"

Response:

{
  "current_page": 1,
  "total": 8,
  "per_page": 50,
  "last_page": 1,
  "data": [
    {
      "shipment_id": "FBA16XXXXX",
      "shipment_name": "Q1 Restock - SKU-001",
      "status": "IN_TRANSIT",
      "destination_fulfillment_center": "PHX7",
      "total_items": 500,
      "total_skus": 3,
      "estimated_arrival_date": "2025-02-01",
      "created_date": "2025-01-20"
    }
  ]
}

Response Fields:

Field	Type	Description
shipment_id	string	Amazon shipment identifier
shipment_name	string	User-assigned shipment name
status	string	Shipment status (e.g., WORKING, SHIPPED, IN_TRANSIT, DELIVERED, CHECKED_IN, RECEIVING, CLOSED)
destination_fulfillment_center	string	Amazon fulfillment center code
total_items	integer	Total number of units in the shipment
total_skus	integer	Number of distinct SKUs
estimated_arrival_date	string	Estimated arrival date (Y-m-d)
created_date	string	Date the shipment was created (Y-m-d)

Python SDK:

shipments = client.warehouse.get_inbound_shipments(
    account_title="My Store US",
    per_page=500
)

for shipment in shipments['data']:
    print(f"Shipment: {shipment['shipment_id']} | Status: {shipment['status']}")
    print(f"Items: {shipment['total_items']} | ETA: {shipment['estimated_arrival_date']}")