ALERT The IRS will be down for maintenance from May 04, 2025 1:00 AM ET to 7:00 AM ET. All other validations will be processed normally.

API Endpoint: Request Details

https://www.tincomply.com/api/v1/request-details

This endpoint retrieves the details of a specific validation request, returning the original request and its results.


Supported Parameters

  • id – The unique identifier of the validation request. (Required)

Response Object

The response object mirrors the original request and its corresponding validation results. The properties in the response will depend on the type of validation performed.


Sample Request

{
    "id": "40L6qZPbl0ilxjkdho0E3gN3"
}

Sample Response

{
    "id": "40L6qZPbl0ilxjkdho0Z3gN3",
    "requestedBy": "API Example Key",
    "request": {
        "tin": "XXXXX1234",
        "name": "JOHN SMITH",
        "requestDate": "2025-02-20T02:59:51",
        "requestedServices": "irs-tin-name-matching"
    },
    "irsTinNameMatchingResult": {
        "message": "TIN and Name combination does not match IRS records",
        "result": 3,
        "completed": true
    },
}