---
title: "Coffee API"
url: "https://devportal.jilson.dev/apis/coffee-api-basic-auth-1/versions/fda4cb4b-55ba-4429-adda-18b0f29a2ef0"
---

# Coffee API

OpenAPI specification document.

```json
{"openapi":"3.1.0","info":{"title":"Coffee API","version":"1.0.0","description":"API for managing coffee orders"},"servers":[{"url":"https://kong-a854e05124usljo2h.kongcloud.dev/","description":"Main server"}],"paths":{"/coffee/hot":{"get":{"summary":"List hot coffee options","description":"Retrieves a list of available hot coffee options with pagination.","operationId":"listHotCoffees","tags":["coffee"],"parameters":[{"name":"limit","in":"query","description":"Maximum number of items to return per page","schema":{"type":"integer","format":"int32","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","description":"Number of items to skip for pagination","schema":{"type":"integer","format":"int32","minimum":0,"default":0}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Coffee"}},"meta":{"type":"object","properties":{"page":{"type":"object","properties":{"limit":{"type":"integer","description":"Number of items per page","example":20},"offset":{"type":"integer","description":"Index of the first item in the current page","example":0},"total":{"type":"integer","description":"Total number of items available","example":100},"estimated_total":{"type":"boolean","description":"Indicates if the total is an estimate","example":true}}}}}}}}}}},"security":[{"basicAuth":[]}]}}},"components":{"schemas":{"Coffee":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the coffee","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef"},"name":{"type":"string","description":"Name of the coffee","example":"Latte"},"description":{"type":"string","description":"Description of the coffee","example":"Rich and creamy coffee with steamed milk"},"price":{"type":"number","format":"float","description":"Price of the coffee","example":3.5}},"required":["id","name","description","price"]}},"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic"}}},"tags":[{"name":"coffee","description":"Operations related to coffee"}]}
```