Skip to main content
GET
/
auth
/
tax-payer
/
{id}
/
token
cURL
curl --request GET \
  --url https://api.trychart.com/auth/tax-payer/{id}/token \
  --header 'Authorization: Bearer <token>'
{
  "access_token": "<string>",
  "taxpayer_id": "<string>",
  "name": "<string>",
  "metadata": {},
  "provider_id": "irs-tax-pro",
  "created_at": "2023-11-07T05:31:56Z",
  "status": "TAX_AUTHORIZATION_SUBMITTED"
}
In certain cases such as client links, you may not have access to the access_token created for the taxpayer. However, all Chart endpoints returning sensitive taxpayer data require an access_token. This endpoint allows you to retrieve the access_token using your Chart client_id and client_secret. Important: This endpoint should be used sparingly and only when absolutely necessary. Please reach out to Chart support if you need to use this endpoint frequently.

Authorizations

​
Authorization
string
header
required

Please use base64 encoded client_id:client_secret. You can use this command to generate the base64 encoded string: echo -n 'client_id:client_secret' | base64

Headers

​
Chart-API-Version
string
default:2024-01-01

Header used to specify the version for a given API request. Current version is 2024-01-01.

Path Parameters

​
id
string
required

The Chart UUID of the taxpayer.

Response

200 - application/json

Access Token Response

​
access_token
string
​
taxpayer_id
string
​
name
string
​
metadata
object
​
provider_id
enum<string>
Available options:
turbotax,
hr,
taxact,
tax_slayer,
jackson,
free_tax_usa,
irs,
irs_tax_pro,
pilot,
cch_axcess,
drake,
proconnect,
chart-sandbox
Example:

"irs-tax-pro"

​
created_at
string<date-time>
​
status
enum<string>
Available options:
CREATED,
CONSENT_RECEIVED,
TAX_AUTHORIZATION_SUBMITTED,
AUTHORIZED,
REJECTED,
COMPLETED
Example:

"TAX_AUTHORIZATION_SUBMITTED"