Spain

Spain eKYB validates the legitimacy of Spanish businesses by checking their tax ID, business name, address, UBOs, and directors against Spanish government sources of truth.

Source

Country	Source	Description
Spain	Spanish government sources of truth	Verifies submitted business details against records maintained in Spanish registries.

Direct API approach

For general integration notes and shared response semantics, see the eKYB API Reference.

Request parameters

Parameter	Required	Description
`plugins`	Mandatory	Array. Must be `["ekyb"]`.
`businessName`	Mandatory	String. Name of the business.
`country`	Mandatory	String. Two-letter Alpha-2 country code. Must be `ES`.
`taxId`	Mandatory	String. Accepts VAT Number or Registration Number. See Tax ID formats for details.
`street`	Optional	String. Street name of the business.
`houseNo`	Optional	String. Building or house number.
`addressLine2`	Optional	String. Second line of the business address.
`city`	Optional	String. City in the business address.
`state`	Optional	String. State in the business address.
`postalCode`	Optional	String. 5-digit Spanish postal code.
`uboNames`	Optional	Array. Full legal names of Unique Beneficial Owners to check against records associated with the business.
`directors`	Optional	Array. Full legal names of directors to check against records associated with the business.

Tax ID formats

Entity Type	Format
Regular company	Letter + 8 digits
Foreign Sole Trader	Letter + 7 digits + Letter
Sole Trader	8 digits + Letter

Sample request

{
  "plugins": ["ekyb"],
  "businessName": "REAL MADRID CLUB DE FUTBOL",
  "street": "Avenida de Concha Espina",
  "houseNo": "1",
  "city": "MADRID",
  "postalCode": "28036",
  "country": "ES",
  "taxId": "XXXXXXXXX",
  "uboNames": ["Sarah Smith"],
  "directors": ["Florentino Perez"]
}

Sample response

{
  "kyb": [
    { "key": "name", "sub_label": "Verified" },
    { "key": "tin", "sub_label": "Found", "reasonCodes": ["REGNO"] },
    { "key": "address_verification", "sub_label": "Verified" },
    { "key": "cityMatch", "sub_label": "Verified" },
    { "key": "postalCodeMatch", "sub_label": "Verified" },
    { "key": "registrationStatus", "sub_label": "Active" },
    {
      "key": "entityType",
      "entityType": { "entityType": "Private limited with Share Capital" }
    },
    { "key": "ubo_name_match", "sub_label": "Unverified", "uboName_input": "Sarah Smith" },
    { "key": "directors_name_match", "sub_label": "Verified", "directorsName_input": "Florentino Perez" }
  ]
}

Response fields

Key	Status	Description
`name`	`Verified`, `Approximate Match`, `Unverified`	Submitted business name against the business name associated with the tax ID.
`tin`	`Found`, `Not Found`	Submitted tax ID against the government database.
`address_verification`	`Verified`, `Approximate Match`, `Unverified`	Submitted address against the address associated with the tax ID.
`cityMatch`	`Verified`, `Approximate Match`, `Unverified`	Submitted city against the city associated with the tax ID.
`postalCodeMatch`	`Verified`, `Unverified`	Submitted postal code against the postal code associated with the tax ID.
`registrationStatus`	`Active`, `Inactive`, `Unknown`	Registration status of the business. `Inactive` includes suspended businesses and those no longer in operation.
`entityType`	Legal entity type of the business	The legal entity type of the company, if available. If not available, displays `Unknown`.
`ubo_name_match`	`Verified`, `Approximate Match`, `Unverified`	Submitted UBO against UBOs associated with the business. Distinguished by the `uboName_input` field on each entry.
`directors_name_match`	`Verified`, `Approximate Match`, `Unverified`	Submitted director against directors associated with the business. Distinguished by the `directorsName_input` field.

Error responses

See the eKYB API Reference for standard error responses.

Single Session Dashboard results

View eKYB results on the Business tab in single Session view.