Lookup Endpoints

Lookup endpoints allow you to retrieve detailed information about specific cocktails and ingredients.

GET/v1/lookup/cocktail

Lookup cocktail by ID

This endpoint allows you to retrieve a cocktail by its unique ID.

Request

GET

/v1/lookup/cocktail

curl -G https://api.protocol.chat/v1/lookup/cocktail \
  -H "Authorization: Bearer {token}" \
  -d id="cocktail_001"

Response

{
  "id": "cocktail_001",
  "name": "Mojito",
  "ingredients": ["Mint", "Lime", "Sugar", "Rum"],
  "instructions": "Muddle mint and lime, add sugar and rum, top with soda water.",
  "image_url": "https://example.com/images/mojito.jpg",
  "created_at": 692233200,
  "updated_at": 705103200
}

GET/v1/lookup/ingredient

Lookup ingredient by ID

This endpoint allows you to retrieve an ingredient by its unique ID.

Request

GET

/v1/lookup/ingredient

curl -G https://api.protocol.chat/v1/lookup/ingredient \
  -H "Authorization: Bearer {token}" \
  -d id="ingredient_001"

Response

{
  "id": "ingredient_001",
  "name": "Mint",
  "description": "A refreshing herb used in many cocktails.",
  "created_at": 692233200,
  "updated_at": 705103200
}