Identifier Check | Apiosk Gateway

About

Offline validation for IBANs, EU VAT numbers, payment cards and mixed batches using checksum algorithms and bundled static bank/BIN data. Pure computation, no caller API key, no outbound provider dependency. The gateway meters access per request over x402.

Base URL

https://gateway.apiosk.com/financial-identifiers

Technical Specs

Auth Methodx402

Response FormatJSON

Endpoints4

Endpoints

Method	Path	Description	Cost
POST	/validate/batch	Validate up to 500 mixed financial identifiers in one call. Each item may specify type iban, vat, card or auto.	$0.02 default	View details
POST	/validate/card	Validate a payment card number with Luhn and classify the network from bundled static BIN range rules.	$0.02 default	View details
POST	/validate/iban	Validate IBAN country format, length, mod-97 checksum and return a bundled static bank-code lookup when known.	$0.02 default	View details
POST	/validate/vat	Validate an EU VAT number with per-country syntax and available offline checksum algorithms.	$0.02 default	View details

Endpoint documentation

POST/validate/batch

$0.02 default

Description

Validate up to 500 mixed financial identifiers in one call. Each item may specify type iban, vat, card or auto.

Pricing

$0.02 default

Request schema

{
  "properties": {
    "items": {
      "items": {
        "type": "object"
      },
      "maxItems": 500,
      "type": "array"
    }
  },
  "required": [
    "items"
  ],
  "type": "object"
}

Response schema

{
  "properties": {
    "count": {
      "type": "integer"
    },
    "results": {
      "items": {
        "type": "object"
      },
      "type": "array"
    }
  },
  "type": "object"
}

Example request

{
  "items": [
    {
      "type": "iban",
      "value": "NL91ABNA0417164300"
    },
    {
      "type": "card",
      "value": "4111111111111111"
    }
  ]
}

Example response

{
  "count": 2,
  "ok": true,
  "results": [
    {
      "valid": true
    },
    {
      "valid": true
    }
  ]
}

POST/validate/card

$0.02 default

Description

Validate a payment card number with Luhn and classify the network from bundled static BIN range rules.

Pricing

$0.02 default

Request schema

{
  "properties": {
    "card": {
      "type": "string"
    }
  },
  "required": [
    "card"
  ],
  "type": "object"
}

Response schema

{
  "properties": {
    "bin": {
      "type": "string"
    },
    "brand": {
      "type": "string"
    },
    "last4": {
      "type": "string"
    },
    "valid": {
      "type": "boolean"
    }
  },
  "type": "object"
}

Example request

{
  "card": "4111111111111111"
}

Example response

{
  "bin": "41111111",
  "brand": "visa",
  "last4": "1111",
  "ok": true,
  "valid": true
}

POST/validate/iban

$0.02 default

Description

Validate IBAN country format, length, mod-97 checksum and return a bundled static bank-code lookup when known.

Pricing

$0.02 default

Request schema

{
  "properties": {
    "iban": {
      "type": "string"
    }
  },
  "required": [
    "iban"
  ],
  "type": "object"
}

Response schema

{
  "properties": {
    "bank_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "checksum_valid": {
      "type": "boolean"
    },
    "country": {
      "type": "string"
    },
    "valid": {
      "type": "boolean"
    }
  },
  "type": "object"
}

Example request

{
  "iban": "NL91ABNA0417164300"
}

Example response

{
  "bank_name": "ABN AMRO",
  "checksum_valid": true,
  "country": "NL",
  "ok": true,
  "valid": true
}

POST/validate/vat

$0.02 default

Description

Validate an EU VAT number with per-country syntax and available offline checksum algorithms.

Pricing

$0.02 default

Request schema

{
  "properties": {
    "vat": {
      "type": "string"
    }
  },
  "required": [
    "vat"
  ],
  "type": "object"
}

Response schema

{
  "properties": {
    "checksum_valid": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "country": {
      "type": "string"
    },
    "valid": {
      "type": "boolean"
    }
  },
  "type": "object"
}

Example request

{
  "vat": "NL123456782B01"
}

Example response

{
  "checksum_valid": true,
  "country": "NL",
  "ok": true,
  "valid": true
}