Warehouses
Manage merchant pickup locations used when quoting deliveries.
A warehouse represents a pickup location owned by the authenticated merchant. Quote requests can use only warehouses belonging to that merchant.
Warehouse status
Warehouses have one of two states:
ACTIVE— available for new delivery quotes.DISABLED— retained in the account but unavailable for new quotes.
Filter the list using a query parameter:
GET /warehouses?status=ACTIVELocation metadata
Provide coordinates and a human-readable address. Longitude is lng; latitude is lat.
{
"name": "Central warehouse",
"nameInt": "central-warehouse",
"status": "ACTIVE",
"address": "12 Rustaveli Avenue, Tbilisi",
"contactPhone": "+995555123456",
"contactEmail": "operations@example.com",
"locationMetadata": {
"display_name": "12 Rustaveli Avenue, Tbilisi",
"lat": 41.7151,
"lng": 44.8271,
"city": "Tbilisi",
"country": "Georgia",
"country_code": "ge"
}
}Deletion can be rejected
A warehouse cannot be deleted after transfers have been associated with it. Disable it instead when preserving historical deliveries is required.
Access isolation
Fetching, updating, or deleting another merchant's warehouse returns 403 UNAUTHORIZED. Melo derives the merchant from the access token; clients never submit a merchant ID.