Skip to main content
POST
/
v1
/
link-access-tokens
Retrieve a link token
curl --request POST \
  --url https://prod.truv.com/v1/link-access-tokens/ \
  --header 'Content-Type: application/json' \
  --header 'X-Access-Client-Id: <api-key>' \
  --header 'X-Access-Secret: <api-key>' \
  --data '
{
  "public_token": "48427a36d43c4d5aa6324bc06c692456"
}
'
{
  "access_token": "48427a36d43c4d5aa6324bc06c692456",
  "link_id": "24d7e80942ce4ad58a93f70ce4115f5c",
  "link_hash": "bc917458a3da4b2c8cc8282aa1707aaa",
  "data_source": "payroll"
}

Authorizations

​
X-Access-Client-Id
string
header
required

Client ID

​
X-Access-Secret
string
header
required

Client Access Key

Body

application/json
​
public_token
string
required

Public token for an exchange

Example:

"48427a36d43c4d5aa6324bc06c692456"

Response

​
access_token
string
required

Access token

Example:

"48427a36d43c4d5aa6324bc06c692456"

​
link_id
string
required

Link ID

Example:

"24d7e80942ce4ad58a93f70ce4115f5c"

​
link_hash
string | null

Link hash

Example:

"bc917458a3da4b2c8cc8282aa1707aaa"

​
data_source
enum<string>

Source of data: payroll - payroll provider parsing, docs - user uploaded documents, insurance - insurance data, financial_accounts - bank data, tax - tax documents, scoring_attributes - transactions scoring attributes report.

Available options:
payroll,
docs,
insurance,
financial_accounts,
tax,
scoring_attributes
Example:

"payroll"