Find the EU VAT ID for every company in a Clay table. Clay sends company name, address and country to Taxora's reverse VAT lookup; Taxora returns the VAT ID, the registered name and address, the tax authority's verdict and a match score – ready to map into columns.
Every lookup needs two headers: your API key and a Bearer token. Clay cannot log in by itself, so create the token once – with curl, Postman or a one-off HTTP API call in Clay – using your Clay credentials.
POST https://api.taxora.io/v1/login
x-api-key: YOUR_API_KEY
Content-Type: application/json
{
"client_id": "YOUR_CLIENT_ID",
"password": "YOUR_CLIENT_SECRET",
"device_name": "clay",
"remember": true
}{
"success": true,
"data": {
"access_token": "123|AbCdEf…",
"token_type": "Bearer",
"expires_in": null
}
}With "remember": true the token does not expire (expires_in is null), so you can paste it into Clay once. Without it, the token is only valid for 60 minutes. Treat the token like a password.
In your Clay table, add an enrichment column of type HTTP API and fill it in like this:
POSThttps://api.taxora.io/v1/smart-enrichmentx-api-key: YOUR_API_KEY
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json{
"companyName": "{{Company Name}}",
"street": "{{Street}}",
"postalCode": "{{Postal Code}}",
"city": "{{City}}",
"country": "{{Country Code}}"
}Replace each placeholder in double curly braces with a reference to the matching column of your Clay table. companyName and country are required; leave out street, postalCode or city if you don't have them. Optional: add "mode": "complex" for hard cases – two independent searches cross-checked against the tax authority, higher hit rate, counts as two checks by default.
If Taxora can answer from data it has already verified, you get the result straight away with HTTP 200:
{
"jobId": "9b2f6c1e-4d7a-4b8e-a3c5-1f2e3d4c5b6a",
"status": "found",
"vatNumber": "ATU12345678",
"vatValid": true,
"confidence": 96,
"nameMatch": "ok",
"officialName": "Example Company GmbH",
"officialAddress": {
"street": "Hauptstraße 10",
"postal_code": "1010",
"city": "Wien",
"country": "AT"
},
"matchedCompanyName": "Example Company GmbH",
"matchedAddress": "Hauptstraße 10, 1010 Wien, AT",
"country": "AT",
"sourceUrl": "https://www.example.at/impressum",
"mode": "default"
}Otherwise Taxora researches the company and confirms the number with the tax authority. Then you get HTTP 202 with a jobId and the status processing. Keep the jobId in its own column.
{
"jobId": "9b2f6c1e-4d7a-4b8e-a3c5-1f2e3d4c5b6a",
"status": "processing"
}Add a second HTTP API column that fetches the job by its jobId (same headers, method GET). For a single lookup it returns the same flat result as above.
GET https://api.taxora.io/v1/smart-enrichment/{{jobId}}
x-api-key: YOUR_API_KEY
Authorization: Bearer YOUR_ACCESS_TOKENLet this column run only for rows whose status is processing or queued. A lookup usually takes a few seconds per row; run the column again for rows that are still processing.
Pick these fields from the JSON response and add them as columns:
Create your API key and Clay credentials under Developer in the Taxora app. See pricing. Questions? Write to [email protected].