API URL
POST /api/v1/iban/{iban}
Headers
Code
Content-Type: application/jsonBody Parameters
Param
Type
Description
iban
required
string
IBAN path or single-validation value; POST body is 15-34 characters after trimming
ibans
required
array
Batch IBAN values; 1-100 items and each POST value is 15-34 characters after trimming
includeMetadata
optional
boolean
Include country and registry details for supported IBANs
Example Request
Code
GET https://datpaq.com/api/v1/iban/DE89%203704%200044%200532%200130%2000?api_key=your-api-keySuccessful Response
Status
HTML
200 OKBody
Code
{
"success": true,
"valid": true,
"normalized": "DE89370400440532013000",
"originalInput": "DE89 3704 0044 0532 0130 00",
"countryCode": "DE",
"country": "Germany",
"checkDigits": "89",
"bban": "370400440532013000",
"coverage": "partial",
"supported": true,
"metadata": {
"country": "Germany",
"countryCode": "DE",
"length": 22,
"currency": "EUR",
"sepa": true,
"sepaInstant": true,
"bban": "370400440532013000",
"formatted": "DE89 3704 0044 0532 0130 00",
"registry": {
"coverage": "partial",
"supportedCountryCount": 37
},
"correlationId": "req-example-iban",
"timestamp": "2026-10-12T12:00:00.000Z",
"processingTime": "2ms",
"api_token_name": null,
"rate_limit": {
"limit": null,
"remaining": null,
"reset": null
}
}
}Field
Type
success
boolean
valid
boolean
normalized
string
originalInput
string
countryCode
string
country
string
checkDigits
string
bban
string
coverage
string
supported
boolean
reason
string
registryMetadata
object
metadata
object
metadata_country
string
metadata_countryCode
string
metadata_length
number
metadata_bban
string
metadata_currency
string
metadata_sepa
boolean
metadata_sepaInstant
boolean
metadata_formatted
string
metadata_registry
object
metadata_correlationId
string
metadata_timestamp
string
metadata_processingTime
string
metadata_api_token_name
string
metadata_rate_limit
object
registry
object
countries
array
countries_countryCode
string
countries_country
string
countries_length
number
countries_currency
string
countries_sepa
boolean
countries_sepaInstant
boolean
summary
object
summary_totalProcessed
number
summary_valid
number
summary_invalid
number
summary_unsupportedCountry
number
results
array
results_index
number
results_iban
string
results_valid
boolean
results_normalized
string
Error Response
Example
Code
HTTP 400 InvalidRequest: Joi body validation fails or a supported-country IBAN has invalid format, length, BBAN structure, or checksum — Request is rejected or returns valid false with a reason; HTTP 401 AuthenticationError: Gateway rejects missing or invalid API-key credentials — Request is not authorized; HTTP 404 NotFound: No service route matches the request path — Unknown path returns endpoint not found; HTTP 422 UnsupportedCoverage: Single validation sees a country code absent from the bundled registry — Response marks coverage unsupported-country; HTTP 429 RateLimitError: More than 1000 requests reach /api/* routes within 15 minutes — Request returns Too many requests; HTTP 500 InternalError: Shared error middleware handles an unhandled route or parser exception — Response returns Internal server errorLast Updated: May 4, 2026