---
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`

## Request

- Base URL: `https://nativeapi.nextgen.com/nge/prod/nge-api/api`
- URL: `https://nativeapi.nextgen.com/nge/prod/nge-api/api/persons/{personId}/chart/tobacco-usage`
- Auth: none declared. Required headers: `Accept`
- TypeScript: <https://skmtc.dev/nextgen/apis/enterprise-api-uscdi-routes/docs/persons/:personId/chart/tobacco-usage/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/nextgen/apis/enterprise-api-uscdi-routes.md) - [All operations](https://skmtc.dev/nextgen/apis/enterprise-api-uscdi-routes/llms.txt) - [OpenAPI document](https://skmtc.dev/nextgen/apis/enterprise-api-uscdi-routes/revisions/191e69116448?raw)