Skip to main content
GET
/
cigars
/
{cigarId}
/
sessions
Get Cigar Sessions
curl --request GET \
  --url https://api.example.com/cigars/{cigarId}/sessions
{
  "data": [
    {}
  ],
  "data.id": "<string>",
  "data.createdAt": "<string>",
  "data.startedAt": "<string>",
  "data.endedAt": "<string>",
  "data.durationSeconds": 123,
  "data.rating": 123,
  "data.note": "<string>",
  "data.user": {},
  "data.user.displayName": "<string>",
  "data.user.avatarUrl": "<string>",
  "data.cigar": {},
  "data.venue": {},
  "meta": {}
}
Returns recent smoke sessions associated with a specific cigar. This endpoint is used internally by the Boxpressd Sites SDK when calling getBoxpressdSessions with a cigarId.
​
cigarId
string
required
The unique Boxpressd cigar identifier.
​
limit
number
The maximum number of sessions to return.
​
offset
number
The number of sessions to skip for pagination.
​
from
string
Return sessions created on or after this ISO date.
​
to
string
Return sessions created on or before this ISO date.

​
SDK Request

const url = `${context.apiBaseUrl}/cigars/${options.cigarId}/sessions${
  query ? `?${query}` : ""
}`

​
Example Request

curl "https://api.boxpressd.com/cigars/cgr_12345/sessions?limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Example Response

{
  "data": [
    {
      "id": "ses_12345",
      "createdAt": "2026-07-18T23:12:00.000Z",
      "startedAt": "2026-07-18T22:00:00.000Z",
      "endedAt": "2026-07-18T23:10:00.000Z",
      "durationSeconds": 4200,
      "rating": 4.8,
      "note": "Excellent evening smoke.",
      "user": {
        "id": "usr_12345",
        "displayName": "Trevor B.",
        "avatarUrl": "https://cdn.boxpressd.com/users/usr_12345.jpg"
      },
      "cigar": {
        "id": "cgr_12345",
        "name": "Philosopher's Folly",
        "brandName": "Example Cigars",
        "imageUrl": "https://cdn.boxpressd.com/cigars/cgr_12345.jpg"
      },
      "venue": {
        "id": "stogies-chapin",
        "name": "Stogies Cigar Lounge & Tap House"
      }
    }
  ],
  "meta": {
    "count": 1,
    "limit": 10,
    "offset": 0
  }
}

​
Response

​
data
BoxpressdSession[]
required
The list of sessions returned for the requested cigar.
​
data.id
string
required
The unique session identifier.
​
data.createdAt
string
required
The date and time the session was created as an ISO string.
​
data.startedAt
string
The date and time the session started as an ISO string.
​
data.endedAt
string
The date and time the session ended as an ISO string.
​
data.durationSeconds
number
The total session duration in seconds.
​
data.rating
number
Optional rating associated with the session.
​
data.note
string
Optional public note associated with the session.
​
data.user
object
required
The public user summary associated with the session.
​
data.user.displayName
string
required
The public display name for the user.
​
data.user.avatarUrl
string
The user’s public avatar URL, when available.
​
data.cigar
object
The cigar associated with the session.
​
data.venue
object
The venue where the session occurred, when available.
​
meta
object
Pagination and result metadata.
import { getBoxpressdSessions } from "@boxpressd/sites-sdk/sessions"

const sessions = await getBoxpressdSessions({
  cigarId: "cgr_12345",
  limit: 10
})