POST v2/Participant/{id}/validation

Creates a new participant or updates an existing participant and validates the Name and TIN combination

Request Information

URI Parameters

NameDescriptionTypeAdditional information
id

Unique identifier of the participant

 string

Required

Body Parameters

TINRequest
NameDescriptionTypeAdditional information
TIN

string

None.
Name

string

None.

Request Formats

application/json, text/json

Sample: 
{
  "TIN": "sample string 1",
  "Name": "sample string 2"
}

text/html

Sample: 
{"TIN":"sample string 1","Name":"sample string 2"}

application/xml, text/xml

Sample: 
<TINRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ITAGroup.TaxValidation.Api.Contracts.v1.Models">
  <Name>sample string 2</Name>
  <TIN>sample string 1</TIN>
</TINRequest>

Response Information

Resource Description

A response containing the participant's validation status including failure results for invalid matches.

TaxValidationResponse
NameDescriptionTypeAdditional information
IsValid

boolean

None.
Messages

Collection of string

None.
FailureResults

FailureResult

None.

Response Codes

  • 200 OK: Participant's validation status returned, including whether the request was valid, messages if invalid format or missing data, and failure results for an invalid match.
  • 401 Unauthorized:
  • 403 Forbidden: Participant is locked out and name and tin combination will not be validated.
  • 500 InternalServerError:

Response Formats

application/json, text/json

Sample: 
{
  "IsValid": true,
  "Messages": [
    "sample string 1",
    "sample string 2"
  ],
  "FailureResults": {
    "FailedAttemptsCount": 1,
    "LockedOutUntil": "2025-12-10T19:21:53.8011966Z",
    "CurrentLockoutPeriod": "00:00:00.1234567",
    "CurrentLockoutMessage": "sample string 3",
    "NextLockoutPeriod": "00:00:00.1234567",
    "NextLockoutMessage": "sample string 5",
    "UnlockCode": "sample string 6"
  }
}

text/html

Sample: 
{"IsValid":true,"Messages":["sample string 1","sample string 2"],"FailureResults":{"FailedAttemptsCount":1,"LockedOutUntil":"2025-12-10T19:21:53.8011966Z","CurrentLockoutPeriod":"00:00:00.1234567","CurrentLockoutMessage":"sample string 3","NextLockoutPeriod":"00:00:00.1234567","NextLockoutMessage":"sample string 5","UnlockCode":"sample string 6"}}

application/xml, text/xml

Sample: 
<TaxValidationResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ITAGroup.TaxValidation.Api.Contracts.v1.Responses">
  <FailureResults>
    <CurrentLockoutMessage>sample string 3</CurrentLockoutMessage>
    <CurrentLockoutPeriod>PT0.1234567S</CurrentLockoutPeriod>
    <FailedAttemptsCount>1</FailedAttemptsCount>
    <LockedOutUntil>2025-12-10T13:21:53.8011966-06:00</LockedOutUntil>
    <NextLockoutMessage>sample string 5</NextLockoutMessage>
    <NextLockoutPeriod>PT0.1234567S</NextLockoutPeriod>
    <UnlockCode>sample string 6</UnlockCode>
  </FailureResults>
  <IsValid>true</IsValid>
  <Messages xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </Messages>
</TaxValidationResponse>