List warehouses

GET

/it/warehouses

GET

/rest/it/warehouses

$ curl -G https://api.letsdeel.com/rest/it/warehouses \
>      -H "Authorization: Bearer <token>" \
>      -d cursor=d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m \
>      -d limit=10 \
>      --data-urlencode "search=London HQ" \
>      -d country=GB \
>      -d type=OFFICE

1 {
2   "data": [
3     {
4       "id": "550e8400-e29b-41d4-a716-446655440000",
5       "name": "London HQ",
6       "type": "OFFICE",
7       "address": {
8         "id": "550e8400-e29b-41d4-a716-446655440000",
9         "city": "Gotham",
10         "type": "DELIVERY",
11         "line1": "1007 Mountain Drive",
12         "line2": "Stately Wayne Manor",
13         "state": "New Jersey",
14         "country": "US",
15         "is_valid": true,
16         "post_code": "12345",
17         "phone_number": "+1-212-456-7890",
18         "date_of_birth": "1997-12-18",
19         "tax_id_number": "BAT123456",
20         "passport_number": "P123456789",
21         "delivery_instructions": "Use the Bat-Signal if urgent"
22       },
23       "ownership": "ORGANIZATION",
24       "public_id": "WRH-550E8400",
25       "created_at": "2024-04-12T14:30:00Z",
26       "updated_at": "2026-06-01T09:12:00Z",
27       "warehouse_type": "ORGANIZATION"
28     }
29   ],
30   "has_more": true,
31   "next_cursor": "d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m0d3m",
32   "total_count": 133
33 }

Returns a cursor-paginated list of warehouses belonging to your organization.

Token scopes: it-assets:read

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

$ curl -X GET 'https://api.deel.training/rest/v2/contracts' \
>   -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.deel.training/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)

AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Query parameters

cursorstringOptional

Indicates where the next page of results starts, as returned in a paginated list response

limitintegerOptional1-100Defaults to 20

Return a page of results with given number of records

searchstringOptional

Free-text search on warehouse name

countrystringOptional

Filter by warehouse country (ISO 3166 alpha-2). Repeat the key to filter on multiple values.

typeenumOptional

Filter by organization warehouse type. Repeat the key to filter on multiple values.

Allowed values:

Response

datalist of objects

has_moreboolean

Whether there are more results available

next_cursorstring or null

Cursor to the next page

total_countlong

Total number of records

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -X GET 'https://api.deel.training/rest/v2/contracts' \
>	-H 'Authorization: Bearer YOUR-TOKEN-HERE'