Documentation

API URL


POST /api/v1/iban/{iban}

Headers
Code
Content-Type: application/json
Body Parameters


Example Request

Code
GET https://datpaq.com/api/v1/iban/DE89%203704%200044%200532%200130%2000?api_key=your-api-key

Successful Response

Status
HTML
200 OK
Body
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
    }
  }
}

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 error

Last Updated:  May 4, 2026