datacheck

Validate phone numbers, credit cards, IBANs, VAT numbers, and postal codes for 40+ countries. Zero dependencies. Powered by datacheck.dev.

Install

npm install datacheck-api

Usage

import datacheck from "datacheck-api";

// Auto-detect type
const result = await datacheck("4111111111111111");
console.log(result.valid);           // true
console.log(result.details.brand);   // "Visa"

// Phone number with location
const phone = await datacheck("+14155551234", { type: "phone" });
console.log(phone.details.location); // "San Francisco, CA"
console.log(phone.details.type);     // "mobile"

// IBAN validation
const iban = await datacheck("DE89370400440532013000", { type: "iban" });
console.log(iban.details.bank_code); // "37040044"

// VAT number
const vat = await datacheck("DE123456789", { type: "vat" });

// Postal code (country required)
const zip = await datacheck("10001", { type: "postal", country: "US" });
console.log(zip.details.region);     // "New York"

Convenience Functions

import { validatePhone, validateCard, validateIBAN, validateVAT, validatePostal } from "datacheck-api";

await validatePhone("+44 7911 123456");
await validateCard("4111111111111111");
await validateIBAN("GB29NWBK60161331926819");
await validateVAT("FR12345678901");
await validatePostal("SW1A 1AA", "GB");

Response Format

{
  "input": "+1 (415) 555-1234",
  "type": "phone",
  "valid": true,
  "formatted": "+1 4155551234",
  "country": "US",
  "details": {
    "country_code": "1",
    "national_number": "4155551234",
    "type": "mobile",
    "area_code": "415",
    "location": "San Francisco, CA"
  },
  "reason": null
}

Options

await datacheck("4111111111111111", {
  type: "credit_card",   // "auto" | "phone" | "credit_card" | "iban" | "vat" | "postal"
  country: "US",         // ISO 3166-1 alpha-2 (required for postal codes)
  baseUrl: "https://datacheck.dev",  // for self-hosted
  timeout: 10000,        // ms
});

Supported Types

| Type | Countries | Details Returned | |------|-----------|-----------------| | Phone | 30+ | type, area code, location | | Credit Card | Universal | brand, BIN, last four | | IBAN | 45+ | bank code, check digits, BBAN | | VAT | 30+ | format name, number body | | Postal | 40+ | region, format |

Links

• Website
• API Docs
• RapidAPI

License

MIT