---
title: "{{baseUrl}}/persons/:personId/chart/tobacco-usage"
method: GET
path: "/persons/{personId}/chart/tobacco-usage"
tags: ["Smoking Status"]
---

# {{baseUrl}}/persons/:personId/chart/tobacco-usage

`GET /persons/{personId}/chart/tobacco-usage`

Gets a list of tobacco usage for the given person id after applying additional OData query operations.

## Path parameters

- `personId` string, required

## Query parameters

- `$top` string, required
- `$filter` string, required
- `$orderby` string, required
- `$skip` string, required
- `$inlinecount` string, required
- `$count` string, required

## Headers

- `Accept` string, required

## Response `200`

OK

- OK96
  - `Items` Item40[], required
    - `encounterId` string, required
    - `personId` string, required
    - `sequenceNumber` string, required
    - `createTimestamp` string, required
    - `maximumTobaccoFreeDuration` string, required
    - `packYears` string, required
    - `passiveExposure` string, required
    - `relapseReason` string, required
    - `tobaccoType` string, required
    - `socialHistoryTobaccoType` string, required
    - `tobaccoUseStatus` string, required
    - `totalPackYears` string, required
    - `triedToQuit` string, required
    - `unitsPerDay` string, required
    - `yearQuit` string, required
    - `yearsUsed` string, required
    - `ageStarted` string, required
    - `ageStopped` string, required
    - `dateStarted` string, required
    - `dateStopped` string, required
    - `smokingStatus` string, required
    - `tobaccoStatus` string, required
    - `usagePerDay` string, required
    - `socialHistoryCreateTimestamp` string, required
    - `tobaccoUserProfileCode` string, required
    - `tobaccoUserProfile` string, required
    - `useDailyCigarette` string, required
    - `ageStartedCigarette` string, required
    - `ageStoppedCigarette` string, required
    - `usagePerDayCigarette` string, required
    - `useDailyCigarillo` string, required
    - `ageStartedCigarillo` string, required
    - `ageStoppedCigarillo` string, required
    - `usagePerDayCigarillo` string, required
    - `useDailyCigar` string, required
    - `ageStartedCigar` string, required
    - `ageStoppedCigar` string, required
    - `usagePerDayCigar` string, required
    - `useDailyPipe` string, required
    - `ageStartedPipe` string, required
    - `ageStoppedPipe` string, required
    - `usagePerDayPipe` string, required
    - `_links` Link[], required
      - `href` string, required
      - `method` string, required
      - `rel` string, required
      - `description` string, required
      - `vendorExtensions` string, required
  - `NextPageLink` string, required
  - `Count` string, required

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/nextgen/apis/enterprise-api-uscdi-routes.md) · [All operations](https://skmtc.net/nextgen/apis/enterprise-api-uscdi-routes/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nextgen/enterprise-api-uscdi-routes/revisions/191e69116448/schema)