Skip to main content
Version: v1

Bottles

Get All Bottles​

This endpoint retrieves all bottles associated to current user.

HTTP Request​

GET /v1/bottles

Query Parameters​

ParameterDefaultDescription
page1The current page
count30The number of items per page

Body Parameters​

ParameterDefaultTypeDescription
futureoptionalbooleanIf the value is 1, you can see your future bottles else you see your bottles in stock

Example​

$ curl --request GET --url 'https://app.winesitting.com/v1/bottles' \
       --header 'AccessKey: YourAccessKey' \
       --header 'SecretKey: YourSecretKey' \
       --header 'content-type: application/json'
       --data '
         {
           "future": 1
         },
       '

Get Cellar​

This endpoint retrieves the user cellar.

HTTP Request​

GET /v1/bottles/consolidated

URL Parameters​

No parameters

tip

This endpoint is the best way to get all information about user cellar (quantity, comment, id...).

Example​

$ curl --request GET --url 'https://app.winesitting.com/v1/bottles/consolidated' \
       --header 'AccessKey: YourAccessKey' \
       --header 'SecretKey: YourSecretKey' \
       --header 'content-type: application/json'

Get a Specific Bottle​

This endpoint retrieves a specific bottle.

HTTP Request​

GET /v1/bottles/{id}

URL Parameters​

ParameterDescription
idThe id of the bottle to retrieve
info

You can't get a specific bottle that you don't own.

Example​

$ curl --request GET --url 'https://app.winesitting.com/v1/bottles/2745263' \
       --header 'AccessKey: YourAccessKey' \
       --header 'SecretKey: YourSecretKey' \
       --header 'content-type: application/json'