GuidesAPI ReferenceChangelogDiscussions
Log In
API Reference

Create a TIN verification request

post
https://api-staging.b2brouter.net/tin_verifications

Submits a batch of TIN (Tax Identification Number) + name pairs for verification against a tax authority census.

Processing is always asynchronous. This endpoint returns 202 Accepted immediately with the request ID and pending status. Use the GET /tin_verifications/{id} endpoint to poll for results, or subscribe to the tin_verification.finished webhook event to be notified when processing completes.

Supported countries: Currently only Spain (es) is supported. The TIN+name pair is validated against the AEAT (Agencia Estatal de Administraci\u00F3n Tributaria) census.

Caching: Results from the last 24 hours are cached. If a TIN was recently verified, the cached result is reused without making a new call to the tax authority.

Billing: Each request counts as one billable transaction (only on success).

Limits: Maximum 20,000 entities per request.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
enum
required

ISO 3166-1 alpha-2 country code. Determines which tax authority census to verify against. Currently only es (Spain) is supported.

Allowed:
Body Params
string
required

The Tax Identification Number to verify. May include the country prefix (e.g. ESB86561412) — it will be stripped during normalization.

string
required

The entity name to verify against the census.

Headers
string
Defaults to 2026-04-20

Specifies the version of the API to use in this request. If not specified uses the API-Version set in the group conifguration B2Brouter UI Application -> Developers -> API Keys -> API Version

Responses

Updated 5 days ago

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 5 days ago