Time	Status	User Agent
Retrieving recent requests…

Time

Status

User Agent

Retrieving recent requests…

Overview

Use this method to get the company tax check results after the company applicant has been reviewed.

Required permissions

To use this method, your app token must have the View check results permission.

Request example

curl -X GET \
     'https://api.sumsub.com/resources/checks/latest?applicantId=63e096c51b6b4030f2e01154&type=COMPANY_TAX' \
     -H 'X-App-Token: <your-app-token>' \
     -H 'X-App-Access-Sig: <your-signature>' \
     -H 'X-App-Access-Ts: <unix-timestamp>'

Response explained

The response represents a list of checks with the company tax check results. All attributes below are nullable.

`checks` element fields

Name	Type	Description
`answer`	String	Check answer. `GREEN` — the check was successful. `RED` — the check failed due to violations found.
`checkType`	String	Always `COMPANY_TAX`. Indicates that the check relies upon the company tax identification number.
`createdAt`	Date	Date and time of the latest company tax check result, in the format `YYYY-MM-DD hh:mm:ss` (for example, `2022-04-05 17:12:31`).
`violations`	Array of strings	Returned when `answer` is `RED`. Specifies the reason(s) why the check failed. `TIN_MISMATCH` — the provided tax identification number does not match official records. `INVALID_DOC_NUMBER` — an invalid or incorrectly formatted tax identification number was provided.

Response examples

If the request is successfully sent and processed, you will get a response like one of the following:

// The check was successful.

{
  "checks": [
    {
      "answer": "GREEN",
      "checkType": "COMPANY_TAX",
      "createdAt": "2026-01-01 00:00:00"
    }
  ]
}

// The check failed due to violations found.

{
  "checks": [
    {
      "answer": "RED",
      "checkType": "COMPANY_TAX",
      "createdAt": "2026-01-01 00:00:00",
      "violations": [
        "TIN_MISMATCH"
      ]
    }
  ]
}

If the request fails, you will receive an HTTP response containing an error code along with a message explaining the error. For example:

{
  "code": 400,
  "correlationId": "49570045bc3f099789516f859b41ef16",
  "description": "Invalid id '123456789'"
}

An empty checks array indicates that the tax check was not performed for the company applicant.

{
  "checks": []
}