Test Card Generator API Reference

Overview

Card Generator works by generating valid test/sample card numbers based on the specified brand and count. It uses predefined rules and algorithms to generate the card numbers, then returns the list of generated card numbers in a structured format.

Live Test Test Card Generator API →

Endpoint

One host, one path per API. The block below shows this call in four languages; every one of them is the same HTTP request. Making requests covers the timeouts, retries and parameter rules that apply to all of them. The SDKs wrap the same call in a typed client.

GEThttps://api.apiverve.com/v1/cardgenerator

1
2

curl "https://api.apiverve.com/v1/cardgenerator?brand=visa&count=5&includeAvatar=true" \
  -H "x-api-key: your_api_key_here"

const res = await fetch('https://api.apiverve.com/v1/cardgenerator?brand=visa&count=5&includeAvatar=true', {
  headers: { 'x-api-key': 'your_api_key_here' },
});

if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);

const { data } = await res.json();
console.log(data);

import requests

res = requests.get(
    "https://api.apiverve.com/v1/cardgenerator?brand=visa&count=5&includeAvatar=true",
    headers={"x-api-key": "your_api_key_here"},
    timeout=15,
)
res.raise_for_status()

print(res.json()["data"])

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/cardgenerator?brand=visa&count=5&includeAvatar=true", nil)
	req.Header.Set("x-api-key", "your_api_key_here")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	out, _ := io.ReadAll(res.Body)
	fmt.Println(string(out))
}

Replace your_api_key_here with the key from your dashboard. When the inputs arrive as a list rather than one at a time, batch requests run up to 200 of them through this same API in a single call.

Authentication

Send your key in the x-api-key header. That is the only auth step — there is no token exchange and no per-endpoint scope to configure. Authentication covers creating, rotating and revoking keys.

401 is the only auth verdict

A 401 means the key is missing, invalid or expired. A 403 means the key is valid but not permitted here — blocked by a key restriction or an IP allow-list. Running out of credits is a 429.

Parameters

Sent in the query string. Premium parameters are accepted on every plan but only take effect on plans that include them.

Parameter	Type	Description
`brand`Optional	string	The brand of the card to generate `visamastercardamexdiscoverjcbdinersunionpay` default visa
`count`OptionalPremium	integer	The number of test card numbers to generate default 1 · range 1–50
`includeAvatar`OptionalPremium	boolean	Include an AI-generated face avatar for the card owner

Response

Every API returns the same three top-level keys, so one response handler covers your whole integration: status, error and data. Only data changes shape. Response format covers the envelope, the other output formats and how premium fields are withheld.

Sample response

{
  "status": "ok",
  "error": null,
  "data": {
    "brand": "visa",
    "count": 5,
    "cards": [
      {
        "cvv": 175,
        "issuer": "SOUTHEAST F.C.U.",
        "id": "0faca124-9a33-4ac6-a3df-8bf103025779",
        "number": "4750377207233152",
        "expiration": "12/2030",
        "brand": "visa",
        "number_alt": {
          "masked": "************3152",
          "unmasked": "4750 3772 0723 3152",
          "last4": "3152"
        }
      },
      {
        "cvv": 129,
        "issuer": "U.S. BANK, N.A.",
        "id": "0d074efe-69e2-4e30-b49a-4cead1ea8411",
        "number": "4431387818727358",
        "expiration": "12/2030",
        "brand": "visa",
        "number_alt": {
          "masked": "************7358",
          "unmasked": "4431 3878 1872 7358",
          "last4": "7358"
        }
      },
      {
        "cvv": 249,
        "issuer": "AUGUSTA VAH F.C.U.",
        "id": "2f01f458-7422-400e-bbcf-41364564193b",
        "number": "4425919427248836",
        "expiration": "12/2030",
        "brand": "visa",
        "number_alt": {
          "masked": "************8836",
          "unmasked": "4425 9194 2724 8836",
          "last4": "8836"
        }
      },
      {
        "cvv": 892,
        "issuer": "CITIZENS SECURITY BANK AND TRUST COMPANY",
        "id": "d311e9d0-f410-4f75-a21f-f14125c88cbb",
        "number": "4127737519045634",
        "expiration": "12/2030",
        "brand": "visa",
        "number_alt": {
          "masked": "************5634",
          "unmasked": "4127 7375 1904 5634",
          "last4": "5634"
        }
      },
      {
        "cvv": 524,
        "issuer": "CREDIT LIBANAIS S.A.L.",
        "id": "64113f4d-c625-43d2-9d82-04f220c9e26f",
        "number": "4741441509416816",
        "expiration": "12/2030",
        "brand": "visa",
        "number_alt": {
          "masked": "************6816",
          "unmasked": "4741 4415 0941 6816",
          "last4": "6816"
        }
      }
    ],
    "owner": {
      "name": "Benny Swaniawski",
      "address": {
        "street": "007 Nelson Mountains",
        "city": "Margueriteton",
        "state": "Washington",
        "zipCode": "39956-7950"
      },
      "avatar": "https://storage.googleapis.com/apiverve/APIResources/faces/Male/30-40/12345678.jpg?X-Goog-Signature=..."
    }
  }
}

Response fields

Paths are relative to data. Premium fields are absent rather than zeroed on plans that do not include them, so check for presence instead of comparing to 0.

Field	Type	Example	Description
`brand`	string	`"visa"`	Card brand for generated test cards
`count`	number	`5`	Total number of generated test cards
`cards`	array[5]		Array of generated test card objects with details
`cvv`	number	`175`	Card verification value security code
`issuer`	string	`"SOUTHEAST F.C.U."`	Financial institution that issued the card
`id`	string	`"0faca124-9a33-4ac6-a3df-8bf103025779"`	Unique identifier for generated card
`number`	string	`"4750377207233152"`	Full test card number for payment testing
`expiration`	string	`"12/2030"`	Card expiration date in MM/YYYY format
`brand`	string	`"visa"`	Card brand identifier (visa, mastercard, etc)
`number_alt`	object	`{...}`
`masked`	string	`"************3152"`	Card number with asterisks masking sensitive digits
`unmasked`	string	`"4750 3772 0723 3152"`	Card number formatted with spaces for readability
`last4`	string	`"3152"`	Last four digits of card number
`owner`Premium	object	`{...}`	Cardholder owner information and address details
`name`Premium	string	`"Benny Swaniawski"`	Full name of the card owner
`address`Premium	object	`{...}`
`street`Premium	string	`"007 Nelson Mountains"`	Street address of card owner
`city`Premium	string	`"Margueriteton"`	City of card owner residence
`state`Premium	string	`"Washington"`	State of card owner residence
`zipCode`Premium	string	`"39956-7950"`	Postal zip code of card owner
`avatar`Premium	string	`"https://storage.googleapis.com/apiverve/APIResources/faces/Male/30-40/12345678.jpg?X-Goog-Signature=..."`	URL to AI-generated face avatar image

Errors

Read the HTTP status first, then error for the specific reason. The body names the parameter that has to change. Error handling covers the full status list and which of them are worth retrying.

Status	Meaning	What to do
`400`	Input was rejected	Read `error`; it names the parameter.
`401`	Key missing or invalid	Check the header name and the key value.
`403`	Key valid, but not permitted	A key restriction or IP allow-list; see key scoping.
`429`	Rate limited, or out of credits	Read `error` to tell them apart; see rate limits.

Use cases

Checkout UI Validation: Frontend developers mock form inputs with formatted unmasked card strings and expiration dates to test responsive payment component styling.
Staging Sandbox Transactions: When staging an ecommerce build, QA engineers submit generated card numbers and CVV codes to sandbox payment processors without exposing real credentials.
Receipt Layout Proofing: Designers populate order confirmation templates using masked card numbers and card brands to verify invoice rendering across email clients.
Form Auto-Formatting QA: Feed raw card numbers into billing inputs to verify that client-side scripts correctly format spacing and extract the last four digits.

Other ways to use Test Card Generator

Set up Test Card Generator on APIVerve, or reach the same source a different way. Your APIVerve account and credits work on all of them — one key, one balance.

Give it to an AI agentConnect over MCP and your agent calls it as a native tool — Claude, Cursor, ChatGPT.VerveKit →Reference →

Google Sheets or ExcelA =VERVE() formula fills a column — no script, no export, recalculates in place.VerveSheets →Reference →

Test Card Generator