---
title: "Validate structured identifiers (IBAN, BIC, VIN, NPI, EIN, crypto addresses, etc.)."
method: POST
path: "/v1/validate/identifier"
tags: ["data"]
---

# Validate structured identifiers (IBAN, BIC, VIN, NPI, EIN, crypto addresses, etc.).

`POST /v1/validate/identifier`

## Request

- Base URL: `https://api.agent-toolbox.ai`
- URL: `https://api.agent-toolbox.ai/v1/validate/identifier`
- Auth: one of:
  - HTTP bearer
  - none

Cost: 1 credit(s). Free tier: 10 calls per IP (no auth).

## Request body

- ValidateIdentifierRequest
  - `value` string
  - `values` string[]
  - `type` 'iban' | 'aba_routing' | 'swift_bic' | 'credit_card' | 'ein' | 'vat_eu' | 'vin' | 'npi' | 'ssn' | 'eth_address' | 'sol_address'
  - `types` string[]

## Response `200`

Success.

- ValidateIdentifierResponse
  - `verdict` 'PASS' | 'FLAG' | 'BLOCK', required
  - `results` object[], required
    - `value` string, required
    - `type` union, required
      - 'iban' | 'aba_routing' | 'swift_bic' | 'credit_card' | 'ein' | 'vat_eu' | 'vin' | 'npi' | 'ssn' | 'eth_address' | 'sol_address'
      - 'unknown'
    - `valid` boolean, required
    - `checksum` 'pass' | 'fail' | 'not_applicable', required
    - `normalized` string
    - `detail` string
  - `counts` object, required
    - `total` integer, required
    - `invalid` integer, required
  - `certificate` string, required: Tamper-evident SHA-256 certificate.
  - `latencyMs` number, required: Server compute time in ms.

## Other responses

- `400`: Invalid request body.
- `402`: Free tier exhausted or insufficient credits.

---

[API](https://skmtc.dev/agent-toolbox/apis/agent-toolbox-ai-api.md) · [All operations](https://skmtc.dev/agent-toolbox/apis/agent-toolbox-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agent-toolbox/apis/agent-toolbox-ai-api/revisions/07132043190b?raw)