Retrieve a photo

One photo of a wine on offer, as the image. It needs no credentials, so the photo_urls that link here work in an <img> tag.

GET

/photos/{id}LIVE

No scope of its ownNo credentials

Path parameter

REQUIRED

idstring

Opaque: PHOTO- and 43 more characters. Use the links photo_urls gives you.

Only photos of offers in the book

Once the offer has left the book, its photo links return NOT_FOUND / 404.

Response

200 OK · 304 Not Modified

The image itself, not the JSON envelope. With the ETag in If-None-Match, an unchanged photo answers 304.

Headers

Content-Typestring

image/jpeg, image/png, image/gif or image/webp.

Cache-Controlstring

public, max-age=86400: a day.

ETagstring

For If-None-Match.

Errors

An unknown id, or a photo Cru cannot fetch from its store or that is not a JPEG, PNG, GIF or WebP image, returns NOT_FOUND / 404, in the JSON envelope. View all error codes →

UP NEXT List your bids

REQUEST EXAMPLE Choose your language

photo.php

<?php

$baseUrl = 'https://us.cruworldwine.com/api/v1';
$id = 'PHOTO-z_9IV8_EHQYwRRmM9no_6nD9YrDn9si7hio_rGyot9Z';

$curl = curl_init($baseUrl . '/photos/' . rawurlencode($id));
curl_setopt_array($curl, [
    CURLOPT_HTTPHEADER => [
        'Accept: image/*',
    ],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_FOLLOWLOCATION => false,
    CURLOPT_TIMEOUT => 30,
]);

$image = curl_exec($curl);
if (curl_getinfo($curl, CURLINFO_RESPONSE_CODE) !== 200) {
    $payload = json_decode($image, true);
    throw new RuntimeException($payload['errors'][0]['code'] ?? 'Unexpected response');
}
// image/jpeg, image/png, image/gif or image/webp
$extension = explode('/', curl_getinfo($curl, CURLINFO_CONTENT_TYPE))[1];
file_put_contents('photo.' . $extension, $image);

RESPONSE EXAMPLE image/*

HTTP/1.1 200 OK
Content-Type: image/jpeg
Cache-Control: public, max-age=86400
ETag: "5f0c2e1a9b7d43c8e6a1f2b4d8c0e3a7b9d1f504"
X-Content-Type-Options: nosniff

…the image’s bytes…

Nothing to send from here. Open any link from an offer’s photo_urls in your browser: the photo is the response.

Documented from the API as built on 15 October 2026.

Retrieve a photo

Path parameter

Response

Headers

Errors

API credentials

Request API access