Checks

Create a check

Idempotency-Key is required and retained for 24 hours. An invalid format or missing registry association is a successful check result, not an HTTP error.

post/checks

Request

  • Base URL: https://vatfind.com/v1
  • URL: https://vatfind.com/v1/checks
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Stable key for safe retries, scoped to workspace, environment, and operation.

Request body

identifier_type'vat_number' | 'tax_identifier' | 'registration_number' required
identifierstring required
country_codestring required
company_namestring
client_referencestring
metadataobject

Example request

{
  "country_code": "GB"
}

Response

Completed check

idstring required
object'check' required
processing_status'completed' required
source'api' | 'mcp' | 'dashboard' | 'monitoring' required
format_status'valid' | 'invalid' | 'not_supported' | 'not_checked' required
registry_match_status'matched' | 'not_matched' | 'ambiguous' | 'unavailable' | 'not_supported' | 'not_checked' required
tax_authority_status'valid' | 'invalid' | 'unavailable' | 'not_applicable' | 'not_supported' | 'not_checked' required
company_legal_status'active' | 'inactive' | 'dissolved' | 'liquidation' | 'insolvency' | 'unknown' | 'unavailable' | 'not_applicable' | 'not_supported' | 'not_checked' required
company_namestring
client_referencestring
metadataobject
credits_usedinteger required
created_atstring date-time required
completed_atstring date-time required

Example response

{
  "identifier": {
    "country_code": "GB"
  },
  "company": {
    "country_code": "GB"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.