Retrieve a paginated list of warehouses

GET

/v1/warehouses

Retrieves a paginated list of warehouses. Supports filtering by name, active status, and sorting.

Required scope: warehouses:read

Request

Authorization

Query Params

Responses

🟢200

application/json

Warehouses retrieved successfully

Bodyapplication/json

🟠400

🟠401

🟠403

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://dev.api.fieldedge.com/open-api/v1/warehouses?offset=&limit=&name=&active=&sort='

Response Example

200 - Paginated list of warehouses

{
    "total": 2,
    "limit": 20,
    "offset": 0,
    "data": [
        {
            "warehouseId": "a1b2c3d4-5e6f-47a8-9b0c-d1e2f3a4b5c6",
            "name": "Central Warehouse",
            "address1": "123 Main St",
            "address2": "Unit 5",
            "city": "Austin",
            "state": "TX",
            "zipCode": "78701",
            "description": "Primary distribution center",
            "active": true
        },
        {
            "warehouseId": "d4c3b2a1-6f5e-84a7-0c9b-6e5f4d3c2b1a",
            "name": "North Warehouse",
            "address1": "456 North Ave",
            "address2": "",
            "city": "Dallas",
            "state": "TX",
            "zipCode": "75201",
            "description": "Overflow storage",
            "active": false
        }
    ]
}

Modified at 2026-08-27 11:27:54

Create a new warehouse

Update an existing warehouse