Skip to main content
POST
/
apps
/
gov-es
/
v1
/
lookup
cURL
curl --request POST \
  --url https://api.invopop.com/apps/gov-es/v1/lookup \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tax_id": "B98602031",
  "name": "Provide One SL",
  "correct": false
}
'
{
  "identified": true,
  "name": "<string>"
}
Verify a Spanish tax ID (NIF/CIF) against the AEAT census without going through the registration flow. The response always reports whether AEAT identified the tax ID; set correct to true to also receive the official name registered with AEAT when the tax ID is identified.

Authorizations

​
Authorization
string
header
required

Use the Bearer scheme with a valid JWT token to authenticate requests.

Example: Authorization: Bearer <token>

Body

application/json
​
tax_id
string
required

Spanish tax ID (NIF/CIF) to verify against AEAT.

Example:

"B98602031"

​
name
string

Name to check against the tax ID. For individuals AEAT verifies that the name matches the tax ID on record; for companies the name is not required to confirm the tax ID exists.

Example:

"Provide One SL"

​
correct
boolean
default:false

When true and the tax ID is identified, the response also includes the official name as registered with AEAT.

Response

The verification completed and the result is reported in the body.

​
identified
boolean

Whether AEAT identified the tax ID.

​
name
string

Official name registered with AEAT. Only present when correct was true in the request and the tax ID was identified.