GenTools API

Generate test data programmatically with our free REST API

Quick Start

curl https://gentools.io/api/v1/identity?count=5
Base URL
https://gentools.io/api/v1
Format
JSON (default)
Rate Limit
100 requests/minute

Common Parameters

ParameterTypeDefaultDescription
countnumber1Number of items to generate (1-100)

Core Generators

Generate identities, names, emails, and other basic data

GET /api/v1/identity

Generate fake identities with name, email, address, phone

Parameters:gender
GET /api/v1/credit-card

Generate credit card numbers with valid Luhn check

Parameters:type
GET /api/v1/address

Generate fake addresses

Parameters:country
GET /api/v1/phone

Generate phone numbers

Parameters:countryformat
GET /api/v1/email

Generate email addresses

Parameters:domain
GET /api/v1/username

Generate usernames

Parameters:style
GET /api/v1/password

Generate secure passwords

Parameters:lengthuppercasenumberssymbols
GET /api/v1/dob

Generate dates of birth

Parameters:minAgemaxAge

Financial

Generate financial data like IBANs, bank accounts, and crypto addresses

GET /api/v1/iban

Generate valid IBAN numbers

Parameters:country
GET /api/v1/bank-account

Generate bank account numbers

Parameters:country
GET /api/v1/crypto

Generate crypto wallet addresses

Parameters:type

Business

Generate business-related data

GET /api/v1/company

Generate company names

Parameters:industry
GET /api/v1/ein

Generate US EIN numbers

GET /api/v1/tracking

Generate tracking numbers

Parameters:carrier

IDs & Documents

Generate various identification numbers

GET /api/v1/uuid

Generate UUIDs

Parameters:version
GET /api/v1/vin

Generate VIN numbers

Parameters:yearmanufacturer
GET /api/v1/isbn

Generate ISBN numbers

GET /api/v1/passport

Generate passport numbers

Parameters:country
GET /api/v1/drivers-license

Generate driver's license numbers

Parameters:statecountry

UK Specific

Generate UK-specific data

GET /api/v1/uk/ni-number

Generate UK National Insurance numbers

GET /api/v1/uk/nhs-number

Generate UK NHS numbers

GET /api/v1/uk/sort-code

Generate UK sort codes

GET /api/v1/uk/address

Generate UK addresses

GET /api/v1/uk/phone

Generate UK phone numbers

US Specific

Generate US-specific data

GET /api/v1/us/ssn

Generate US Social Security numbers

GET /api/v1/us/routing-number

Generate US routing numbers

GET /api/v1/us/address

Generate US addresses

GET /api/v1/us/phone

Generate US phone numbers

India Specific

Generate India-specific data

GET /api/v1/india/aadhaar

Generate Aadhaar numbers

GET /api/v1/india/pan

Generate PAN card numbers

GET /api/v1/india/gst

Generate GST numbers

GET /api/v1/india/ifsc

Generate IFSC codes

GET /api/v1/india/address

Generate India addresses

GET /api/v1/india/phone

Generate India phone numbers

Canada Specific

Generate Canada-specific data

GET /api/v1/canada/sin

Generate Canadian SIN numbers

GET /api/v1/canada/address

Generate Canadian addresses

GET /api/v1/canada/phone

Generate Canadian phone numbers

Australia Specific

Generate Australia-specific data

GET /api/v1/australia/tfn

Generate Australian TFN numbers

GET /api/v1/australia/abn

Generate Australian ABN numbers

GET /api/v1/australia/medicare

Generate Medicare numbers

GET /api/v1/australia/address

Generate Australian addresses

GET /api/v1/australia/phone

Generate Australian phone numbers

Ireland Specific

Generate Ireland-specific data

GET /api/v1/ireland/pps

Generate Irish PPS numbers

GET /api/v1/ireland/eircode

Generate Irish Eircodes

GET /api/v1/ireland/address

Generate Irish addresses

Germany Specific

Generate Germany-specific data

GET /api/v1/germany/steuer-id

Generate German Steuer-ID (Tax ID) numbers

France Specific

Generate France-specific data

GET /api/v1/france/siret

Generate French SIRET/SIREN numbers

GET /api/v1/france/nir

Generate French NIR (Social Security) numbers

Italy Specific

Generate Italy-specific data

GET /api/v1/italy/codice-fiscale

Generate Italian Codice Fiscale (Tax Code)

Spain Specific

Generate Spain-specific data

GET /api/v1/spain/dni

Generate Spanish DNI numbers

GET /api/v1/spain/nie

Generate Spanish NIE numbers (foreigners)

Netherlands Specific

Generate Netherlands-specific data

GET /api/v1/netherlands/bsn

Generate Dutch BSN (Citizen Service Number)

Poland Specific

Generate Poland-specific data

GET /api/v1/poland/pesel

Generate Polish PESEL numbers

Sweden Specific

Generate Sweden-specific data

GET /api/v1/sweden/personnummer

Generate Swedish Personnummer (Personal ID)

Brazil Specific

Generate Brazil-specific data

GET /api/v1/brazil/cpf

Generate Brazilian CPF numbers (individuals)

GET /api/v1/brazil/cnpj

Generate Brazilian CNPJ numbers (companies)

Mexico Specific

Generate Mexico-specific data

GET /api/v1/mexico/curp

Generate Mexican CURP numbers

GET /api/v1/mexico/rfc

Generate Mexican RFC numbers

Parameters:type

Japan Specific

Generate Japan-specific data

GET /api/v1/japan/my-number

Generate Japanese My Number (Individual Number)

GET /api/v1/japan/corporate-number

Generate Japanese Corporate Numbers

South Korea Specific

Generate South Korea-specific data

GET /api/v1/south-korea/rrn

Generate Korean RRN (Resident Registration Number)

China Specific

Generate China-specific data

GET /api/v1/china/citizen-id

Generate Chinese Citizen ID numbers

Validators

Validate various data formats

GET /api/v1/validate/credit-card

Validate credit card number

Parameters:number
GET /api/v1/validate/iban

Validate IBAN number

Parameters:iban
GET /api/v1/validate/email

Validate email format

Parameters:email

Response Format

Success Response

{
  "success": true,
  "count": 2,
  "data": [
    { "firstName": "John", "lastName": "Doe", ... },
    { "firstName": "Jane", "lastName": "Smith", ... }
  ]
}

Error Response

{
  "success": false,
  "error": "Invalid parameter",
  "code": "INVALID_PARAM"
}

Code Examples

JavaScript (Fetch)

fetch('https://gentools.io/api/v1/identity?count=5')
  .then(res => res.json())
  .then(data => console.log(data));

Python

import requests

response = requests.get('https://gentools.io/api/v1/identity',
                        params={'count': 5})
data = response.json()
print(data)

cURL

curl "https://gentools.io/api/v1/identity?count=5"