Namso Gen Test

API Documentation

Integrate our powerful test data generation APIs into your applications. Get started with our RESTful APIs for BIN generation, user creation, and data validation.

Get API Access

Quick Start

1. Get Your API Key

// Your API key will look like this:
API_KEY: "ngt_1234567890abcdef"

2. Base URL

BASE_URL: https://api.namso-gentest.com/v1

3. Authentication

Include your API key in the Authorization header:

Authorization: Bearer ngt_1234567890abcdef

BIN Generator API

Generate BIN Numbers

POST /generate/bin

Request Body:

{ "prefix": "424242", // Optional: BIN prefix "card_type": "visa", // visa, mastercard, amex, discover "quantity": 10, // Number of cards to generate "include_expiry": true, // Include expiry date "include_cvv": true, // Include CVV "format": "json" // json, csv, xml }

Response:

{ "success": true, "data": [ { "number": "4242424242424242", "expiry": "12/28", "cvv": "123", "type": "visa", "valid": true } ], "count": 10, "rate_limit": { "remaining": 990, "reset": 1640995200 } }

Random User API

Generate Random Users

GET /generate/users

Query Parameters:

?results=10 // Number of users (1-100) &gender=male // male, female, or omit for both &nat=us,ca,gb // Nationality codes &age_min=18 // Minimum age &age_max=65 // Maximum age &include_login=true // Include login credentials &format=json // json, csv, xml

Response:

{ "success": true, "data": [ { "name": { "title": "Mr", "first": "John", "last": "Doe" }, "email": "john.doe@example.com", "phone": "+1-555-123-4567", "address": { "street": "123 Main St", "city": "New York", "state": "NY", "country": "United States", "postcode": "10001" }, "login": { "username": "johndoe123", "password": "password123" }, "dob": { "date": "1990-05-15", "age": 33 } } ], "count": 10 }

Validator API

Validate Card Numbers

POST /validate/card

Request Body:

{ "numbers": [ "4242424242424242", "5555555555554444" ] }

Response:

{ "success": true, "results": [ { "number": "4242424242424242", "valid": true, "card_type": "visa" }, { "number": "5555555555554444", "valid": true, "card_type": "mastercard" } ] }

Rate Limits & Pricing

Starter Plan

$29/month

• 50,000 requests/month
• 100 requests/minute
• Basic support

Professional

$99/month

• 500,000 requests/month
• 1,000 requests/minute
• Priority support
• Custom formats

Enterprise

Custom

• Unlimited requests
• Custom rate limits
• Dedicated support
• White-label options

Error Codes

400 - Bad Request

Invalid request parameters or missing required fields.

401 - Unauthorized

Invalid or missing API key.

429 - Rate Limited

Too many requests. Check your rate limits.

500 - Server Error

Internal server error. Please try again later.

SDKs & Libraries

🟨

JavaScript

npm install namso-gen-test

🐍

Python

pip install namso-gen-test

☕

Java

Coming Soon

💎

Ruby

Coming Soon

Get Started with API Access