Retrieve a warehouse

One Cru warehouse by its code, such as UK_DRAK: name, market, address, bond references, delivery instructions, and whether your inbond wine sells through it.

GET

/warehouses/{code}LIVE

Required scopemeta:readAuthentication requiredTry it

Path parameter

REQUIRED

codestring

UK_DRAK, HK_KERRY, SG_TOLL, FR_DARTESS, US_NAPA. Case-insensitive.

Response fields

200 OK

Fields returned in data.warehouse.

codestring

UK_DRAK, HK_KERRY, SG_TOLL, FR_DARTESS, US_NAPA.

namestring

The warehouse’s short name.

marketstring | null

The Cru site the warehouse belongs to, such as uk.

addressobject

street, city, region, postcode and country (an ISO country code), each nullable.

phonestring | null

Contact number.

bond_referencesarray<string>

Excise and bond references to quote when delivering in bond.

delivery_instructionsstring | null

Plain text, with line breaks as \n.

sells_your_inbond_wineboolean

Whether wine you hold outside Cru can be sold through it: the warehouse_code values POST /offers and POST /market/bids/{code}/sell accept from you. False on every row for an account not set up for it.

settlement_feenumber | null

Taken from each unit of that wine sold through it, in currency: 0.0 for a corporate account, and null where sells_your_inbond_wine is false.

currencystring

Your market’s currency.

Errors

An unknown code returns NOT_FOUND / 404. Missing or invalid credentials return AUTH_INVALID_CREDENTIALS / 401. A credential without meta:read gets AUTH_INSUFFICIENT_SCOPE / 403. View all error codes →

UP NEXT List inbond warehouses

REQUEST EXAMPLE Choose your language

warehouse.php

<?php

$baseUrl = 'https://us.cruworldwine.com/api/v1';
$code = 'UK_DRAK';

$curl = curl_init($baseUrl . '/warehouses/' . rawurlencode($code));
curl_setopt_array($curl, [
    CURLOPT_HTTPHEADER => [
        'CLIENT-KEY: ' . getenv('CRU_CLIENT_KEY'),
        'CLIENT-SECRET: ' . getenv('CRU_CLIENT_SECRET'),
        'Accept: application/json',
    ],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_FOLLOWLOCATION => false,
    CURLOPT_TIMEOUT => 30,
]);

$payload = json_decode(curl_exec($curl), true);
if (($payload['status'] ?? null) !== 'OK') {
    throw new RuntimeException($payload['errors'][0]['code'] ?? 'Unexpected response');
}
print_r($payload['data']);

RESPONSE EXAMPLE application/json

{
  "status": "OK",
  "message": "Warehouse retrieved successfully",
  "meta": {
    "version": "1.0",
    "timestamp": "2026-10-19T10:10:55Z",
    "request_id": "6b183f2425c81699f1f3d3e5"
  },
  "data": {
    "warehouse": {
      "code": "UK_DRAK",
      "name": "Drakes Bonded Warehouse",
      "market": "uk",
      "address": {
        "street": "Example Way",
        "city": "Example Town",
        "region": null,
        "postcode": "AB1 2CD",
        "country": "GB"
      },
      "phone": null,
      "bond_references": [
        "GBWK000000000"
      ],
      "delivery_instructions": "Book deliveries 48 hours ahead.\nQuote the Cru reference on every pallet.",
      "sells_your_inbond_wine": true,
      "settlement_fee": 6.0,
      "currency": "GBP"
    }
  }
}

Prices are decimal amounts in the market’s currency.
30780.5 GBP = £30,780.50. Learn more ↗

Try this endpoint GET

Configure your request, then send it to your Cru environment.

Documented from the API as built on 15 October 2026.

Retrieve a warehouse

Path parameter

Response fields

Errors

API credentials

Request API access