PATCH
/
core
/
kyc
/
processes
/
tax-details
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
      }
    }
  }
}'
{
  "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

​
Authorization
string
header
required

OAuth 2.0 authentication.

Headers

​
Accept-Language
string

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.