---
title: "GET /tax-payer"
method: GET
path: "/tax-payer"
---

# GET /tax-payer

`GET /tax-payer`

## Request

- Base URL: `https://api.trychart.com`
- URL: `https://api.trychart.com/tax-payer`
- Auth: HTTP bearer

Retrieve taxpayer information associated with an `access_token`.

## Response `200`

Introspect Response

- TaxpayerResponse
  - `id` string, required: The Chart UUID of the taxpayer. Returned from the /auth/token endpoint.
  - `name` string, required
  - `metadata` object: Custom metadata identifying external fields about the taxpayer.
  - `provider_id` 'turbotax' | 'hr' | 'taxact' | 'tax_slayer' | 'jackson' | 'free_tax_usa' | 'irs' | 'irs_tax_pro' | 'pilot' | 'cch_axcess' | 'drake' | 'proconnect' | 'chart-sandbox', required
  - `created_at` string, date-time, required
  - `status` 'CREATED' | 'CONSENT_RECEIVED' | 'TAX_AUTHORIZATION_SUBMITTED' | 'AUTHORIZED' | 'REJECTED' | 'COMPLETED', required
  - `analysis` TaxpayerAnalysis
    - `total_liabilities` number: The total tax liabilities of the taxpayer.
    - `liabilities_with_lien_filed` number: The total tax liabilities of the taxpayer calculated for each year with a federal tax lien filed.
    - `tin` string: The TIN of the taxpayer.
    - `employment_history` object[]: Historical employment records from W2s and wage and income documents
      - `type` 'W2' | 'WAID-W2' | '1099NEC' | 'WAID-1099NEC', required: Document type - W2 or Wage and Income Document
      - `year` string, required: Tax year
      - `employer` object, required
        - `ein` string, required: Employer Identification Number
        - `name` string, required: Employer name
        - `address` string, required: Employer address
  - `details` object: Taxpayer's account details depending on the provider.
    - `address` object
      - `street_address` string
      - `city` string
      - `state` string
      - `zip_code` string
    - `balance_summary` object
      - `balance_due` number
      - `tax_years` object[]
        - `amount` number
        - `year` string
  - `form8821` string: A pre-signed URL pointing to the raw IRS Form 8821 file retrieved from the provider. Returns a PDF file. The URL expires after 12 hours.

---

[API](https://skmtc.dev/trychart/apis/chart-api.md) - [All operations](https://skmtc.dev/trychart/apis/chart-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trychart/apis/chart-api/revisions/fac67e8a1281?raw)