Skip to main content
GET
Retrieve contact tax details
A contact’s tax details are filled in when the recipient submits an information request that asked for tax, or when someone enters them in the Slash dashboard. informationRequestId tells the two apart. Each submission or edit replaces the previous details; this endpoint always returns the current ones.

Authorizations

​
X-API-Key
string
header
required

User API key authentication. Create a key under Settings → API keys in the Slash dashboard (https://app.slash.com/global-settings/api-keys) and send the x-legal-entity header naming the legal entity to act on with every request. Keys scoped to a legal entity are rejected with 403 user_api_key_required.

Headers

​
x-legal-entity
string
required

The legal entity to act on. Required on every request; a user API key can act on any legal entity its user has access to.

Pattern: ^le_[a-zA-Z0-9]+$

Path Parameters

​
contactId
string
required

Contact id with the le_c_ prefix.

Response

The contact's current tax details.

The tax details on file for a Contact. federalTaxClassification is set for US recipients only. The taxpayer identification number itself is never returned.

​
contactId
string
required

Contact id with the le_c_ prefix.

​
legalName
string
required

Legal name as reported for tax purposes.

​
countryCode
string
required

ISO 3166-1 alpha-2 country of tax residence.

Required string length: 2
​
taxIdType
enum<string>
required

Kind of taxpayer identification number on file. The number itself is never returned.

Available options:
ssn,
ein,
itin,
foreign_tin
​
updatedAt
string<date-time>
required

When these tax details were last written.

​
federalTaxClassification
enum<string>

Federal tax classification as reported on a W-9.

Available options:
individual,
sole_proprietor,
c_corporation,
s_corporation,
partnership,
trust_estate,
llc_c,
llc_s,
llc_partnership,
other
​
address
Address · object

Address as reported for tax purposes. Can differ from the contact's address.

​
email
string

Email address for tax correspondence.

​
informationRequestId
string

Information request the recipient submitted these details through, with the le_c_info_req_ prefix. Absent when the details were entered in the Slash dashboard.