Skip to main content
POST
/
merchant
/
vat
/
vat_number_validate_history
Vat Number Validation History
curl --request POST \
  --url https://api.unibee.dev/merchant/vat/vat_number_validate_history \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "count": 123,
  "countryCode": "<string>",
  "createTimeEnd": 123,
  "createTimeStart": 123,
  "page": 123,
  "searchKey": "<string>",
  "sortField": "<string>",
  "sortType": "<string>",
  "status": [
    123
  ],
  "validateGateway": "<string>",
  "vatNumber": "<string>"
}
'
{
  "code": 123,
  "data": {
    "numberValidateHistoryList": [
      {
        "companyAddress": "<string>",
        "companyName": "<string>",
        "countryCode": "<string>",
        "createTime": 123,
        "id": 123,
        "manualValidate": true,
        "merchantId": 123,
        "status": 123,
        "validateGateway": "<string>",
        "validateMessage": "<string>",
        "vatNumber": "<string>"
      }
    ],
    "total": 123
  },
  "merchantId": 123,
  "message": "<string>",
  "redirect": "<string>",
  "requestId": "<string>"
}

Endpoint Overview

POST https://api.unibee.dev/merchant/vat/vat_number_validate_history Vat Number Validation History

Authorization

All UniBee Merchant API requests require authentication via API key.
HeaderRequiredDescription
AuthorizationYesBearer <your_api_key>
Content-TypeYesapplication/json (for request body)

Parameters

Parameters for this endpoint are listed below. The schema is also shown in the Try it panel.

Request body

NameTypeRequiredDescription
countintegerNoCount Of Per Page
countryCodestringNoCountryCode
createTimeEndintegerNoCreateTimeEnd,UTC timestamp,seconds
createTimeStartintegerNoCreateTimeStart,UTC timestamp,seconds
pageintegerNoPage, Start 0
searchKeystringNoSearch Key, vatNumber, validateGateway, company, company address, message
sortFieldstringNoSort Field,gmt_create|gmt_modify,Default gmt_modify
sortTypestringNoSort Type,asc|desc,Default desc
statusarrayNostatus, 0-Invalid,1-Valid
validateGatewaystringNoFilter Validate Gateway, vatsense
vatNumberstringNoFilter Vat Number

Request examples

cURL

curl -X POST "https://api.unibee.dev/merchant/vat/vat_number_validate_history" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "count": 0,
  "countryCode": "",
  "createTimeEnd": 0,
  "createTimeStart": 0,
  "page": 0,
  "searchKey": "",
  "sortField": "",
  "sortType": "",
  "status": [],
  "validateGateway": "id_example",
  "vatNumber": ""
}'

Sandbox

curl -X POST "https://api-sandbox.unibee.top/merchant/vat/vat_number_validate_history" \
  -H "Authorization: Bearer YOUR_SANDBOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "count": 0,
  "countryCode": "",
  "createTimeEnd": 0,
  "createTimeStart": 0,
  "page": 0,
  "searchKey": "",
  "sortField": "",
  "sortType": "",
  "status": [],
  "validateGateway": "id_example",
  "vatNumber": ""
}'

Response

Success responses return a JSON envelope with code, data, message, redirect, and requestId. code 0 indicates success.
FieldTypeDescription
codeintegerResponse code. 0 = success
dataobjectResponse payload
data.numberValidateHistoryListarrayNumberValidateHistoryList
data.totalintegerTotal
messagestringHuman-readable message
requestIdstringRequest ID for support

Error handling

HTTP statusMeaning
400Bad request — invalid or missing parameters. Check message in the body.
401Unauthorized — missing or invalid API key.
404Not found — invalid path or resource.
500Server error — retry with backoff.
When code in the response body is non-zero, check message for details. Use requestId when contacting support.

Authorizations

Authorization
string
header
required

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

Body

application/json
count
integer<int>

Count Of Per Page

countryCode
string<string>

CountryCode

createTimeEnd
integer<int64>

CreateTimeEnd,UTC timestamp,seconds

createTimeStart
integer<int64>

CreateTimeStart,UTC timestamp,seconds

page
integer<int>

Page, Start 0

searchKey
string<string>

Search Key, vatNumber, validateGateway, company, company address, message

sortField
string<string>

Sort Field,gmt_create|gmt_modify,Default gmt_modify

sortType
string<string>

Sort Type,asc|desc,Default desc

status
integer<int>[]

status, 0-Invalid,1-Valid

validateGateway
string<string>

Filter Validate Gateway, vatsense

vatNumber
string<string>

Filter Vat Number

Response

200 - application/json
code
integer<int>
data
object
merchantId
integer<int64>
message
string<string>
redirect
string<string>
requestId
string<string>