Home🔒 DocumentationAPI Reference🔒 Changelog
FIX APIAPI Status

Tax ID Information

This document has two types:

  1. IDENTIFICATION_INFO: Details corresponding to the User
  2. JOINT_IDENTIFICATION_INFO: Details corresponding to the Joint account holder linked to this User

When creating Joint accounts on the platform, both of these documents should be provided on the User object.

📘

Collect Tax ID numbers only

Ask your customer for the ID number they use for tax reporting purposes in their jurisdiction. If an individual has multiple national ID numbers, the one they use for tax purposes should be collected.

Field

Required

Type

Values

Description

type

✅

string

"IDENTIFICATION_INFO"
"JOINT_IDENTIFICATION_INFO"

Type of user document. Default to "IDENTIFICATION_INFO"

data

✅

object

"IDENTIFICATION_INFO"

Document object that contains all data for the "IDENTIFICATION_INFO" user document

data.value

✅

string

National Identification Number (e.g. SSN, National ID, etc)

Please exclude all -'s from the request

data.type

✅

string

  • "SSN" – Social Security Number
  • "TIN" – Tax Identification Number
  • "other"

Type of National Identification Number.

data.citizenship

✅

string

Country of citizenship. Follows the ISO 3166-1 alpha-3 standard. Use List All Countries

data.usTaxPayer

✅ (must be asked, but can be false)

boolean

true
false

Customer Tax Country, if true W9 is created, if false W-8BEN is created

{
  "type": "IDENTIFICATION_INFO",
  "data": {
    "value": "111223333",
    "type": "SSN",
    "citizenship": "USA",
    "usTaxPayer" : true
  }
}