POST
/
trn
/
validate
/
batch
curl --request POST \
  --url https://rest.taxes.provider.com/api/v1/trn/validate/batch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "batchName": "x-trn-batch",
  "trns": [
    {
      "trn": 40303265045,
      "country": {
        "code": "FR"
      }
    },
    {
      "trn": 50303265045,
      "country": {
        "code": "UK"
      }
    }
  ]
}'

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Contains required properties for batch of tax registration numbers validation request

​
trns
object[]
required

List of tax registration numbers

​
batchName
string

Name of the batch

​
externalId
string

Way to relate the request for future reference. Hold the reference value passed in request, expecting the same would be returned in response.

Response

200 - application/json

Contains the required properties for batch of tax registration numbers validation response

​
batchId
string
required

Id of the batch request.

​
limit
integer
required

Use for the pagination for batch request, limit indicates the maximum number of records to be returned in the response.

​
offset
integer
required

Use for the pagination for batch request, offset indicates the starting point of records to be returned in the response.

​
status
enum<string>
required

This field indicates current status of the request at server side.

Available options:
COMPLETED,
FAILED,
RUNNING,
CANCELED
​
trns
object[]
required

List of tax registration numbers

​
batchName
string

Name of the batch request.

​
completionPercentage
integer

Percentage of batch request processing.

​
externalId
string

The externalId passed in request.

Fetch the health status of the Service Provider.Validate the tax registration number