Core API
- Concepts
- Authentication
- Countries
- Users
- KYC
- Introduction
- GETGet overview
- PATCHUpdate email
- PATCHUpdate phone
- PATCHUpdate profile
- PATCHUpdate address
- PATCHUpdate identity
- PATCHUpdate proof of address
- PATCHUpdate customer due diligence
- PATCHUpdate enhanced due diligence
- PATCHUpdate crypto risk assessment
- PATCHUpdate self-categorization statement
- PATCHUpdate tax details
- Webhooks
- Capabilities
- Terms of Service
- Files
- Assets
- Accounts
- External Accounts
- Transactions
- Portfolio
- Webhooks
Widgets API
- Payment
KYC
Update tax details
Update the tax details process for a user.
PATCH
/
core
/
kyc
/
processes
/
tax-details
Copy
Ask AI
curl --request PATCH \
--url https://api.enterprise.sandbox.uphold.com/core/kyc/processes/tax-details \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"input": {
"formId": "7a0f4229-e3de-4dfd-8f91-9b1308b2dc33",
"answers": {
"tax-details": {
"continue": true
}
}
}
}'
Copy
Ask AI
{
"taxDetails": {
"status": "pending",
"input": {
"formId": "bbe3b6cd-a5a8-4e86-84b3-be83292de2ef",
"answers": {
"tax-details": {
"continue": true
}
}
},
"hint": {
"type": "form",
"formId": "bbe3b6cd-a5a8-4e86-84b3-be83292de2ef",
"schema": {
"properties": {
"tax-details": {
"type": "object",
"title": "Tax Details",
"properties": {
"continue": {
"type": "boolean",
"title": "Continue",
"const": true
}
},
"unevaluatedProperties": false,
"required": [
"continue"
]
},
"tax-identification": {
"type": "object",
"title": "Taxpayer Identification and Certification",
"description": "We'll ask you to provide your Social Security number (SSN) or Taxpayer Identification Number (TIN) and certify that your information is correct by submitting a W-9 Form. This will allow our partner, TaxBit, to issue your tax forms each year.<br><br>Why is this needed? As a regulated financial institution, Uphold is legally required to collect and verify your SSN/TIN so the U.S. Internal Revenue Service (IRS) can properly assess taxes that may be due.",
"properties": {
"tin": {
"type": "string",
"pattern": "^\\S.*\\S$|^\\S$",
"title": "What's your SSN/TIN number?"
},
"w9-certify-all": {
"type": "boolean",
"title": "Certify to all.",
"description": "<h4>W-9 Form</h4><p>Please certify the information below is correct.</p><p>Under the penalty of perjury, I certify that:</p><ul><li>The Social Security number (SSN) previously provided is correct.</li><li>I am not subject to backup withholding because:<ul><li>I am exempt from backup withholding, or</li><li>I have not been notified by the Internal Revenue Service (IRS) that I am subject to backup withholding as a result of a failure to report all interest or dividends, or</li><li>the IRS has notified me that I am no longer subject to backup withholding.</li></ul></li><li>I am a U.S. citizen or other U.S. person.</li><li>The FATCA code entered on this form (if any) indicating that I am exempt from FATCA reporting is correct.</li><li>The IRS does not require my consent to any provision of this document other than the certifications required to prevent backup withholding.</li></ul>",
"const": true
},
"w9-signature": {
"type": "string",
"title": "Full legal name",
"description": "<b>E-Signature</b><p>I acknowledge that by typing my name below, as per the E-Sign Act, I am providing an e-signature that is the legal equivalent to my manual signature.</p>",
"pattern": "(?:\\w+[ ]+){1,}\\w+"
}
},
"unevaluatedProperties": false,
"required": [
"tin",
"w9-certify-all",
"w9-signature"
]
}
},
"type": "object"
},
"uiSchema": {
"type": "Categorization",
"elements": [
{
"type": "Category",
"label": "Tax Details",
"elements": [
{
"type": "Control",
"scope": "#/properties/tax-details/properties/continue"
}
]
},
{
"type": "Category",
"label": "Taxpayer Identification and Certification",
"elements": [
{
"scope": "#/properties/tax-identification/properties/tin",
"type": "Control"
},
{
"scope": "#/properties/tax-identification/properties/w9-certify-all",
"type": "Control"
},
{
"scope": "#/properties/tax-identification/properties/w9-signature",
"type": "Control"
}
]
}
]
}
}
}
}
Update tax details is the endpoint used to submit the form that collects the user’s tax information, such as their TIN and the details required for submitting the IRS Form W-9.
This process is exempt for all users who are non-U.S. taxpayers — that is, users who do not reside in the United States and do not hold U.S. citizenship.
When calling GET /core/kyc?detailed=taxDetails
, you will get a hint
property which includes a JSON form schema and UI schema.
The hint
property will also be available in responses of this endpoint, in case there are still questions to be answered.
For more information about forms, refer to the form-based processes section.
Authorizations
OAuth 2.0 authentication.
Headers
The natural language and locale that the client prefers.
Body
application/json
Response
200
application/json
KYC tax details process updated.
The response is of type object
.
Copy
Ask AI
curl --request PATCH \
--url https://api.enterprise.sandbox.uphold.com/core/kyc/processes/tax-details \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"input": {
"formId": "7a0f4229-e3de-4dfd-8f91-9b1308b2dc33",
"answers": {
"tax-details": {
"continue": true
}
}
}
}'
Copy
Ask AI
{
"taxDetails": {
"status": "pending",
"input": {
"formId": "bbe3b6cd-a5a8-4e86-84b3-be83292de2ef",
"answers": {
"tax-details": {
"continue": true
}
}
},
"hint": {
"type": "form",
"formId": "bbe3b6cd-a5a8-4e86-84b3-be83292de2ef",
"schema": {
"properties": {
"tax-details": {
"type": "object",
"title": "Tax Details",
"properties": {
"continue": {
"type": "boolean",
"title": "Continue",
"const": true
}
},
"unevaluatedProperties": false,
"required": [
"continue"
]
},
"tax-identification": {
"type": "object",
"title": "Taxpayer Identification and Certification",
"description": "We'll ask you to provide your Social Security number (SSN) or Taxpayer Identification Number (TIN) and certify that your information is correct by submitting a W-9 Form. This will allow our partner, TaxBit, to issue your tax forms each year.<br><br>Why is this needed? As a regulated financial institution, Uphold is legally required to collect and verify your SSN/TIN so the U.S. Internal Revenue Service (IRS) can properly assess taxes that may be due.",
"properties": {
"tin": {
"type": "string",
"pattern": "^\\S.*\\S$|^\\S$",
"title": "What's your SSN/TIN number?"
},
"w9-certify-all": {
"type": "boolean",
"title": "Certify to all.",
"description": "<h4>W-9 Form</h4><p>Please certify the information below is correct.</p><p>Under the penalty of perjury, I certify that:</p><ul><li>The Social Security number (SSN) previously provided is correct.</li><li>I am not subject to backup withholding because:<ul><li>I am exempt from backup withholding, or</li><li>I have not been notified by the Internal Revenue Service (IRS) that I am subject to backup withholding as a result of a failure to report all interest or dividends, or</li><li>the IRS has notified me that I am no longer subject to backup withholding.</li></ul></li><li>I am a U.S. citizen or other U.S. person.</li><li>The FATCA code entered on this form (if any) indicating that I am exempt from FATCA reporting is correct.</li><li>The IRS does not require my consent to any provision of this document other than the certifications required to prevent backup withholding.</li></ul>",
"const": true
},
"w9-signature": {
"type": "string",
"title": "Full legal name",
"description": "<b>E-Signature</b><p>I acknowledge that by typing my name below, as per the E-Sign Act, I am providing an e-signature that is the legal equivalent to my manual signature.</p>",
"pattern": "(?:\\w+[ ]+){1,}\\w+"
}
},
"unevaluatedProperties": false,
"required": [
"tin",
"w9-certify-all",
"w9-signature"
]
}
},
"type": "object"
},
"uiSchema": {
"type": "Categorization",
"elements": [
{
"type": "Category",
"label": "Tax Details",
"elements": [
{
"type": "Control",
"scope": "#/properties/tax-details/properties/continue"
}
]
},
{
"type": "Category",
"label": "Taxpayer Identification and Certification",
"elements": [
{
"scope": "#/properties/tax-identification/properties/tin",
"type": "Control"
},
{
"scope": "#/properties/tax-identification/properties/w9-certify-all",
"type": "Control"
},
{
"scope": "#/properties/tax-identification/properties/w9-signature",
"type": "Control"
}
]
}
]
}
}
}
}
Assistant
Responses are generated using AI and may contain mistakes.