---
title: "Search expressions"
method: GET
path: "/api/v1/expressions"
tags: ["Expressions"]
---

# Search expressions

`GET /api/v1/expressions`

## Request

- Base URL: `https://api.instadram.me/v1`
- URL: `https://api.instadram.me/v1/api/v1/expressions`
- Auth: HTTP bearer

## Query parameters

- `q` string
- `limit` integer
- `offset` integer
- `distillery` string
- `proof_min` number
- `proof_max` number
- `price_min` number
- `price_max` number

## Response `200`

List of expressions

- object
  - `success` boolean
  - `data` Expression[]
    - `id` string: Expression ID
    - `name` string: Expression name
    - `distillery_id` string: Distillery ID
    - `distillery_name` string: Distillery name
    - `mash_bill` string: Mash bill composition
    - `abv` number: Alcohol by volume percentage
    - `proof` number: Proof
    - `msrp` number: Manufacturer suggested retail price
    - `msrp_source` string: Source of MSRP information
    - `description` string: Expression description
    - `age_statement` string: Age statement
    - `batch_number` string: Batch number
    - `barrel_type` string: Barrel type
    - `filtration` string: Filtration method
    - `bottle_size` string: Bottle size
    - `limited_edition` boolean: Whether this is a limited edition
    - `tasting_notes` object
      - `aroma` string: Aroma notes
      - `palate` string: Palate notes
      - `finish` string: Finish notes
    - `awards` string[]: Awards received
    - `availability` string: Availability status
    - `created_at` string, date-time: Creation timestamp
    - `updated_at` string, date-time: Last update timestamp
  - `pagination` Pagination
    - `total_count` integer: Total number of items
    - `limit` integer: Number of items per page
    - `offset` integer: Number of items to skip
    - `page` integer: Current page number
    - `total_pages` integer: Total number of pages
    - `has_next` boolean: Whether there is a next page
    - `has_prev` boolean: Whether there is a previous page

---

[API](https://skmtc.dev/instadram/apis/instadram-api.md) · [All operations](https://skmtc.dev/instadram/apis/instadram-api/llms.txt) · [OpenAPI document](https://skmtc.dev/instadram/apis/instadram-api/revisions/2971df0f7ef1?raw)