Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

TheCocktailDB Lookup API

Retrieve details by ID

TheCocktailDB Lookup API is one of 5 APIs that TheCocktailDB publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Lookup. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 2 operations across 2 paths, and defines 2 schemas. It is described by OpenAPI 3.0.3, at version 1.0.

Requests are made against a single base URL, https://www.thecocktaildb.com/api/json/v1/1.

2 operations 2 paths 2 schemas 2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0
Base URL
https://www.thecocktaildb.com/api/json/v1/1
Resource Areas
1

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 GET. Each is listed below with its method, path, parameters, and response codes.

Lookup 2

Retrieve details by ID

GET
/lookup.php
TheCocktailDB Lookup Cocktail or Ingredient by ID
lookupById 2 params → 200
GET
/random.php
TheCocktailDB Get a Random Cocktail
getRandomCocktail → 200

Schemas 2

The contract defines 2 schemas that model the data the API accepts and returns. The most detailed are Drink (25 properties), CocktailsResponse (1 property). Each schema is shown below with its type and property counts.

Drink
object
Full cocktail details including ingredients, instructions, and media
25 properties
CocktailsResponse
object
Response containing a list of cocktails
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

thecocktaildb-lookup-api-openapi.yml Raw ↑

Other APIs TheCocktailDB publishes across the network.

TheCocktailDB API
TheCocktailDB Filter API
TheCocktailDB List API
TheCocktailDB Search API