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.

Creates a new pour for the authenticated user. Can optionally include a review and tasting notes in the same request.

​
Endpoints

​
Basic Pour Creation

POST /api/v1/pours

​
Pour with Review

POST /api/v1/pours/with_review

​
Request Body

​
pour.pourable_type
string
required
The type of item being poured. Can be “Bottle”, “Collectable”.
​
pour.pourable_id
string
required
The ID of the specific item being poured.
​
pour.pour_size
string
The size of the pour in ounces (e.g., “1.0”, “2.5”).
​
pour.serve_style
string
How the spirit was served (one of “neat”, “rocks”).
​
pour.price
string
The cost of the pour in dollars (e.g., “15.00”, “10.5”).
​
pour.location
string
Where the pour was consumed.
​
pour.batch_id
string
The ID of the specific batch if applicable.
​
pour.vintage_id
string
The ID of the specific vintage if applicable.
​
pour.private
boolean
Whether the pour should be private (default: false).
​
review.rating
decimal
Rating from 0-5 (only for create_with_review endpoint).
​
review.comment
string
Review comment (only for create_with_review endpoint).
​
review.private
boolean
Whether the review should be private (only for create_with_review endpoint).
​
review.would_purchase_again
boolean
Whether the user would purchase this spirit again (only for create_with_review endpoint).
​
tasting.tasting_note_ids
array
Array of tasting note IDs to associate with the pour (only for create_with_review endpoint).
curl -X POST https://api.onlydrams.app/api/v1/pours \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -d '{
    "pour": {
      "pourable_type": "Bottle",
      "pourable_id": "123e4567-e89b-12d3-a456-426614174000",
      "pour_size": "2.0",
      "serve_style": "neat",
      "price": "15.00",
      "location": "The Scotsman",
      "private": false
    }
  }'

curl -X POST https://api.onlydrams.app/api/v1/pours/with_review \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -d '{
    "pour": {
      "pourable_type": "Bottle",
      "pourable_id": "123e4567-e89b-12d3-a456-426614174000",
      "pour_size": "2.0",
      "serve_style": "neat",
      "price": "15.00",
      "location": "The Scotsman"
    },
    "review": {
      "rating": 4.5,
      "comment": "Excellent bourbon with great vanilla notes",
      "would_purchase_again": true
    },
    "tasting": {
      "tasting_note_ids": ["uuid", "uuid2", "uuid3"]
    }
  }'

{
  "id": "1ef8c97b-ac1c-4363-a947-24d93636921a",
  "pour_size": "2.5",
  "serve_style": "neat",
  "price": "10.5",
  "location": null,
  "private": true,
  "created_at": "2025-07-07T18:59:58.796Z",
  "updated_at": "2025-07-07T18:59:58.796Z",
  "user": {
    "id": "7bef31a7-5714-4ccc-9f2b-f16f55f4d553",
    "email": "chris@chrisvannoy.com",
    "name": "",
    "first_name": null,
    "last_name": null,
    "username": "cvannoy",
    "bio": null,
    "banner_url": null,
    "avatar_url": "https://storage.googleapis.com/onlydrams/y6zgpztsh5ljbjeqm2g030zo9bur",
    "verified": false,
    "collection_count": 2,
    "following": 1,
    "followers": 0,
    "is_following": false,
    "tier": "",
    "is_collection_private": false
  },
  "pourable": {
    "type": "collectable",
    "collectable": {
      "pickable": false,
      "proof": 100.0,
      "price": 75.0,
      "note": null,
      "purchased_on": "2025-04-18",
      "purchased_at": {
        "id": "106e465d-f788-48eb-b609-7b0939d44b9b",
        "name": "Virginia ABC"
      },
      "card_expanded": true,
      "status": "opened",
      "picked_by": null,
      "allowBarrelPick": false,
      "barrelPickEnabled": false,
      "fill_level": 80,
      "bottle_id": "059482ab-ccd6-4767-b459-6489bd0761c2",
      "batches": [],
      "vintages": [],
      "lists": [],
      "batch_id": null,
      "vintage_id": null
    }
  },
  "batch": null,
  "vintage": null,
  "tasting_notes": []
}

{
  "pour": {
    "id": "0516196f-b1e7-4106-9a41-6c58d0219ddf",
    "pour_size": "2.0",
    "serve_style": "neat",
    "price": null,
    "location": null,
    "private": false,
    "created_at": "2025-07-07T16:34:53.648Z",
    "updated_at": "2025-07-07T16:34:53.648Z",
    "user": {
      "id": "7bef31a7-5714-4ccc-9f2b-f16f55f4d553",
      "email": "chris@chrisvannoy.com",
      "name": "",
      "first_name": null,
      "last_name": null,
      "username": "cvannoy",
      "bio": null,
      "banner_url": null,
      "avatar_url": "https://storage.googleapis.com/onlydrams/y6zgpztsh5ljbjeqm2g030zo9bur",
      "verified": false,
      "collection_count": 2,
      "following": 1,
      "followers": 0,
      "is_following": false,
      "tier": "",
      "is_collection_private": false
    },
    "pourable": {
      "type": "collectable",
      "collectable": {
        "pickable": false,
        "proof": 92.0,
        "price": 0.0,
        "note": null,
        "purchased_on": null,
        "purchased_at": null,
        "card_expanded": true,
        "status": "opened",
        "picked_by": null,
        "allowBarrelPick": false,
        "barrelPickEnabled": false,
        "fill_level": 68,
        "bottle_id": "6720d4cb-b7a2-4866-9945-2390c0d91609",
        "batches": [],
        "vintages": [],
        "lists": [],
        "batch_id": null,
        "vintage_id": null
      }
    },
    "batch": null,
    "vintage": null,
    "tasting_notes": [
      {
        "id": "326c5b05-ed74-4ac7-b119-a3fa82b7424d",
        "name": "Test Note"
      }
    ]
  },
  "review": {
    "id": "afe64e15-81ac-406f-9e4e-80d1ae0955e4",
    "comment": "Peaty af",
    "rating": 3.5,
    "bottle_id": "6720d4cb-b7a2-4866-9945-2390c0d91609",
    "juice": {
      "id": "cb8ffb92-195d-4132-a9bb-e144c5ce7492",
      "name": "Ozark Distillery Bourbon Whiskey",
      "image_url": "https://storage.googleapis.com/onlydrams/fi1bzbye8rnchokij6sw3nwqh5hz"
    },
    "private": false,
    "would_purchase_again": null,
    "batch": null,
    "vintage": null
  }
}

​
Error Responses

{
  "errors": {
    "pourable_type": ["can't be blank"],
    "pourable_id": ["can't be blank"]
  }
}