Skip to main content

Documentation Index

Fetch the complete documentation index at: https://api.docs.onlydrams.app/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve pours for the authenticated user or another user (if the pours are public).

​
Endpoints

​
List User’s Pours

GET /api/v1/pours

​
List Another User’s Pours

GET /api/v1/users/:user_id/pours

​
Get Specific Pour

GET /api/v1/pours/:id

​
Get Specific Pour by User

GET /api/v1/users/:user_id/pours/:id

​
Parameters

​
user_id
string
The ID of the user whose pours to retrieve (for user-specific endpoints).
​
id
string
required
The ID of the specific pour to retrieve.
​
page
integer
Page number for pagination (default: 1).
​
per
integer
Number of items per page (default: 20).
curl -X GET https://api.onlydrams.app/api/v1/pours \
  -H "Authorization: Bearer $ACCESS_TOKEN"

curl -X GET https://api.onlydrams.app/api/v1/users/123e4567-e89b-12d3-a456-426614174000/pours \
  -H "Authorization: Bearer $ACCESS_TOKEN"

curl -X GET https://api.onlydrams.app/api/v1/pours/456e7890-e89b-12d3-a456-426614174001 \
  -H "Authorization: Bearer $ACCESS_TOKEN"

{
  "total": 25,
  "has_more": true,
  "data": [
    {
      "id": "456e7890-e89b-12d3-a456-426614174001",
      "pour_size": "2.0",
      "serve_style": "neat",
      "price": "15.00",
      "location": "The Scotsman",
      "private": false,
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z",
      "user": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "username": "user123"
      },
      "pourable": {
        "id": "789e0123-e89b-12d3-a456-426614174003",
        "name": "Buffalo Trace Bourbon",
        "image_url": "https://example.com/bottle.jpg"
      },
      "batch": null,
      "vintage": null,
      "tasting_notes": []
    },
    {
      "id": "789e0123-e89b-12d3-a456-426614174002",
      "pour_size": "1.5",
      "serve_style": "rocks",
      "price": "12.00",
      "location": "Local Bar",
      "private": true,
      "created_at": "2024-01-14T15:45:00Z",
      "updated_at": "2024-01-14T15:45:00Z",
      "user": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "username": "user123"
      },
      "pourable": {
        "id": "abc12345-e89b-12d3-a456-426614174003",
        "name": "Eagle Rare Single Barrel",
        "image_url": "https://example.com/bottle.jpg"
      },
      "batch": null,
      "vintage": null,
      "tasting_notes": []
    }
  ]
}

{
  "id": "456e7890-e89b-12d3-a456-426614174001",
  "pour_size": "2.0",
  "serve_style": "neat",
  "price": "15.00",
  "location": "The Scotsman",
  "private": false,
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z",
  "user": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "username": "user123"
  },
  "pourable": {
    "id": "789e0123-e89b-12d3-a456-426614174003",
    "name": "Buffalo Trace Bourbon",
    "image_url": "https://example.com/bottle.jpg"
  },
  "batch": null,
  "vintage": null,
  "tasting_notes": []
}

​
Error Responses

{
  "error": "Pour not found"
}

{
  "error": "User not found"
}