Skip to content
GET /v1/lookup

Full cocktail by id

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/cocktails-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/cocktails-api/v1/lookup" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/cocktails-api/v1/lookup", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/cocktails-api/v1/lookup");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/cocktails-api/v1/lookup",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "id": "11007",
        "name": "Margarita",
        "tags": [
            "IBA",
            "ContemporaryClassic"
        ],
        "glass": "Cocktail glass",
        "video": null,
        "category": "Ordinary Drink",
        "alcoholic": "Alcoholic",
        "thumbnail": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg",
        "ingredients": [
            {
                "measure": "1 1/2 oz",
                "ingredient": "Tequila"
            },
            {
                "measure": "1/2 oz",
                "ingredient": "Triple sec"
            },
            {
                "measure": "1 oz",
                "ingredient": "Lime juice"
            },
            {
                "measure": null,
                "ingredient": "Salt"
            }
        ],
        "instructions": "Rub the rim of the glass with the lime slice to make the salt stick to it. Take care to moisten only the outer rim and sprinkle the salt on it. The salt should present to the lips of the imbiber and never mix into the cocktail. Shake the other ingredients with ice, then carefully pour into the glass."
    },
    "meta": {
        "timestamp": "2026-05-30T02:58:48.498Z",
        "request_id": "b1583981-8853-46e2-8845-7f7ab01b9214"
    },
    "status": "ok",
    "message": "Cocktail retrieved successfully",
    "success": true
}