Fake Transaction Data API

Q: Do amounts and dates respect my bounds?

Yes — minAmount/maxAmount and from/to genuinely constrain every record; that's contract-tested, not decorative.

Q: What do records include?

Id, amount with ISO currency, type, status, description, merchant and an ISO 8601 timestamp — a checkout table in one call.

MOCK DATA

Fake account transactions with realistic merchants, weighted statuses and currency-correct amounts — filter by type, status, amount range and date window.

Generated test data for fixtures and development

Base URL: /api/transactions
Category: Commerce & Finance
Capabilities: 1 route Seedable
Last updated: July 29, 2026

GET /api/transactions Generate fake account transactions Returns a list

Live requestRuns against the public API

No key required

GET/api/transactions?seed=42

Request parameters

minAmountdefault 0.01

Smallest possible amount, inclusive.

maxAmountdefault 5000

Largest possible amount, inclusive. Must be ≥ minAmount.

currencydefault USD

ISO 4217 currency code (3 letters, case-insensitive). Amounts are rounded to the currency's minor unit — JPY/KRW give whole numbers, KWD three decimals. Unknown codes are a 400. Supported: USD, EUR, GBP, JPY, CNY, CHF, CAD, AUD, NZD, SEK, NOK, DKK, PLN, CZK, SGD, HKD, KRW, INR, BRL, MXN, ZAR, TRY, KWD.

type

Only generate this transaction type. Omit for a realistic weighted mix (payments most common).

status

Only generate this status. Omit for the weighted mix: 80% completed, 12% pending, 8% failed.

from

Earliest possible timestamp, inclusive (YYYY-MM-DD or ISO 8601). Defaults to 90 days before 'to'.

to

Latest possible timestamp, inclusive — date-only values mean midnight UTC. Defaults to the request time. Must be ≥ 'from'.

Advanced response options7 options

countdefault 10

How many records to generate (1–100).

seed

Deterministic output: the same seed always returns the same records. Omit for random (the used seed is echoed in meta.seed).

fields

Return only these fields (comma-separated). Mutually exclusive with 'exclude'.

exclude

Return all fields except these (comma-separated).

formatdefault json

Response format: json envelope, ndjson (one record per line) or csv.

prettydefault false

Pretty-print the JSON response.

unwrapdefault false

Drop the envelope: return the raw array/object without data/meta wrapper.

Response

Example parameters are ready. Send the request to inspect the live response.

Route reference

Code, request parameters, response fields and verified examples 14 params · 9 fields · 4 examples

Code samples Ready-to-copy requests in 4 languages

curl JavaScript Python PHP

curl "https://randomapi.dev/api/transactions?seed=42"

const res = await fetch("https://randomapi.dev/api/transactions?seed=42");
const { data, meta } = await res.json();

import requests

data = requests.get("https://randomapi.dev/api/transactions?seed=42").json()["data"]

$json = json_decode(file_get_contents(
  "https://randomapi.dev/api/transactions?seed=42"
), true);
$data = $json["data"];

Parameters Route-specific request inputs 7

Parameter	Type	Default & allowed	Description
`minAmount`	float	default: 0.01 allowed: 0 – 10000000 example: 10	Smallest possible amount, inclusive.
`maxAmount`	float	default: 5000 allowed: 0 – 10000000 example: 250.75	Largest possible amount, inclusive. Must be ≥ minAmount.
`currency`	string	default: USD allowed: 3 – 3 example: EUR	ISO 4217 currency code (3 letters, case-insensitive). Amounts are rounded to the currency's minor unit — JPY/KRW give whole numbers, KWD three decimals. Unknown codes are a 400. Supported: USD, EUR, GBP, JPY, CNY, CHF, CAD, AUD, NZD, SEK, NOK, DKK, PLN, CZK, SGD, HKD, KRW, INR, BRL, MXN, ZAR, TRY, KWD.
`type`	enum	allowed: payment \| refund \| transfer \| deposit \| withdrawal example: payment	Only generate this transaction type. Omit for a realistic weighted mix (payments most common).
`status`	enum	allowed: completed \| pending \| failed example: completed	Only generate this status. Omit for the weighted mix: 80% completed, 12% pending, 8% failed.
`from`	date	example: 2026-01-01	Earliest possible timestamp, inclusive (YYYY-MM-DD or ISO 8601). Defaults to 90 days before 'to'.
`to`	date	example: 2026-03-31	Latest possible timestamp, inclusive — date-only values mean midnight UTC. Defaults to the request time. Must be ≥ 'from'.

minAmount float

Smallest possible amount, inclusive.

default: 0.01

allowed: 0 – 10000000

example: minAmount=10

maxAmount float

Largest possible amount, inclusive. Must be ≥ minAmount.

default: 5000

allowed: 0 – 10000000

example: maxAmount=250.75

currency string

default: USD

allowed: 3 – 3

example: currency=EUR

type enum

Only generate this transaction type. Omit for a realistic weighted mix (payments most common).

allowed: payment | refund | transfer | deposit | withdrawal

example: type=payment

status enum

Only generate this status. Omit for the weighted mix: 80% completed, 12% pending, 8% failed.

allowed: completed | pending | failed

example: status=completed

from date

Earliest possible timestamp, inclusive (YYYY-MM-DD or ISO 8601). Defaults to 90 days before 'to'.

example: from=2026-01-01

to date

Latest possible timestamp, inclusive — date-only values mean midnight UTC. Defaults to the request time. Must be ≥ 'from'.

example: to=2026-03-31

Universal parameters Shared response and formatting options 7

Parameter	Type	Default & allowed	Description
`count`	int	default: 10 allowed: 1 – 100 example: 3	How many records to generate (1–100).
`seed`	int	example: 42	Deterministic output: the same seed always returns the same records. Omit for random (the used seed is echoed in meta.seed).
`fields`	list	example: id,amount	Return only these fields (comma-separated). Mutually exclusive with 'exclude'.
`exclude`	list	example: reference	Return all fields except these (comma-separated).
`format`	enum	default: json allowed: json \| ndjson \| csv example: csv	Response format: json envelope, ndjson (one record per line) or csv.
`pretty`	boolean	default: false example: true	Pretty-print the JSON response.
`unwrap`	boolean	default: false example: true	Drop the envelope: return the raw array/object without data/meta wrapper.

count int

How many records to generate (1–100).

default: 10

allowed: 1 – 100

example: count=3

seed int

Deterministic output: the same seed always returns the same records. Omit for random (the used seed is echoed in meta.seed).

example: seed=42

fields list

Return only these fields (comma-separated). Mutually exclusive with 'exclude'.

example: fields=id,amount

exclude list

Return all fields except these (comma-separated).

example: exclude=reference

format enum

Response format: json envelope, ndjson (one record per line) or csv.

default: json

allowed: json | ndjson | csv

example: format=csv

pretty boolean

Pretty-print the JSON response.

default: false

example: pretty=true

unwrap boolean

Drop the envelope: return the raw array/object without data/meta wrapper.

default: false

example: unwrap=true

Response schema Fields returned in each record 9

Field	Type	Description	Example
`id`	string	Processor-style transaction id: 'txn_' + 24 lowercase hex characters.	txn_9f2c4b7a1e8d3f6a5c0b2e4d
`amount`	float	Amount within minAmount..maxAmount, rounded to the currency's minor unit (whole numbers for JPY/KRW).	129.99
`currency`	string	ISO 4217 code the amount is denominated in.	USD
`type`	string	payment \| refund \| transfer \| deposit \| withdrawal.	payment
`status`	string	completed \| pending \| failed — weighted 80/12/8 when not filtered.	completed
`description`	string	Human-readable line, always coherent with the type and naming the merchant.	Payment to Lumen Coffee Roasters
`merchant`	string	Counterparty drawn from a pool matching the type (store, account, payer or ATM).	Lumen Coffee Roasters
`timestamp`	string (ISO 8601)	When the transaction happened — always within the from..to window.	2026-05-14T09:23:41.512Z
`reference`	string	Bank-statement reference: 'REF-' + 6 uppercase alphanumerics.	REF-7K2M9Q

id string

Processor-style transaction id: 'txn_' + 24 lowercase hex characters.

example: txn_9f2c4b7a1e8d3f6a5c0b2e4d

amount float

Amount within minAmount..maxAmount, rounded to the currency's minor unit (whole numbers for JPY/KRW).

example: 129.99

currency string

ISO 4217 code the amount is denominated in.

example: USD

type string

payment | refund | transfer | deposit | withdrawal.

example: payment

status string

completed | pending | failed — weighted 80/12/8 when not filtered.

example: completed

description string

Human-readable line, always coherent with the type and naming the merchant.

example: Payment to Lumen Coffee Roasters

merchant string

Counterparty drawn from a pool matching the type (store, account, payer or ATM).

example: Lumen Coffee Roasters

timestamp string (ISO 8601)

When the transaction happened — always within the from..to window.

example: 2026-05-14T09:23:41.512Z

reference string

Bank-statement reference: 'REF-' + 6 uppercase alphanumerics.

example: REF-7K2M9Q

Documented examples

Build-generated requests and complete responses 4

Ten transactions from the past 90 days /api/transactions?seed=42

GET /api/transactions?seed=42

{
  "data": [
    {
      "id": "txn_016cfb6a5c85eac58cdd40fb",
      "amount": 509.1,
      "currency": "USD",
      "type": "refund",
      "status": "completed",
      "description": "Refund from Cloudline Airways",
      "merchant": "Cloudline Airways",
      "timestamp": "2026-06-17T15:01:45.359Z",
      "reference": "REF-DNSNH1"
    },
    {
      "id": "txn_248abeccba6fd45df91c3667",
      "amount": 1389.43,
      "currency": "USD",
      "type": "payment",
      "status": "completed",
      "description": "Payment to PixelWare Games",
      "merchant": "PixelWare Games",
      "timestamp": "2026-07-29T00:32:42.904Z",
      "reference": "REF-H7T93X"
    },
    {
      "id": "txn_0902c05ac838fecf0b9c4166",
      "amount": 1088.2,
      "currency": "USD",
      "type": "deposit",
      "status": "completed",
      "description": "Deposit from Halcyon Design Studio",
      "merchant": "Halcyon Design Studio",
      "timestamp": "2026-06-20T19:57:01.937Z",
      "reference": "REF-8VNRAM"
    },
    {
      "id": "txn_da52e1ef2ffb70a746915c00",
      "amount": 155.71,
      "currency": "USD",
      "type": "payment",
    …
    "generatedAt": "2026-07-29T08:13:22.000Z"
  }
}

Refunds between €10 and €100 /api/transactions?type=refund&currency=EUR&minAmount=10&maxAmount=100&count=5

GET /api/transactions?type=refund&currency=EUR&minAmount=10&maxAmount=100&count=5

{
  "data": [
    {
      "id": "txn_8016cfb6a5c85eac58cdd40f",
      "amount": 42.19,
      "currency": "EUR",
      "type": "refund",
      "status": "completed",
      "description": "Refund from Orchard Lane Grocers",
      "merchant": "Orchard Lane Grocers",
      "timestamp": "2026-05-29T17:14:05.327Z",
      "reference": "REF-0DNSNH"
    },
    {
      "id": "txn_f248abeccba6fd45df91c366",
      "amount": 27.98,
      "currency": "EUR",
      "type": "refund",
      "status": "completed",
      "description": "Refund from Brightcart Market",
      "merchant": "Brightcart Market",
      "timestamp": "2026-06-17T10:38:28.649Z",
      "reference": "REF-RH7T93"
    },
    {
      "id": "txn_90902c05ac838fecf0b9c416",
      "amount": 21.02,
      "currency": "EUR",
      "type": "refund",
      "status": "pending",
      "description": "Refund from Nimbus Streaming",
      "merchant": "Nimbus Streaming",
      "timestamp": "2026-06-11T23:40:40.997Z",
      "reference": "REF-O8VNRA"
    },
    {
      "id": "txn_fda52e1ef2ffb70a746915c0",
      "amount": 10.11,
      "currency": "EUR",
      "type": "refund",
    …
    "generatedAt": "2026-07-29T08:13:22.000Z"
  }
}

Completed whole-yen payments in Q1 2026 /api/transactions?currency=JPY&type=payment&status=completed&from=2026-01-01&to=2026-03-31&count=20

GET /api/transactions?currency=JPY&type=payment&status=completed&from=2026-01-01&to=2026-03-31&count=20

{
  "data": [
    {
      "id": "txn_58016cfb6a5c85eac58cdd40",
      "amount": 2294,
      "currency": "JPY",
      "type": "payment",
      "status": "completed",
      "description": "Payment to Solstice Fitness Club",
      "merchant": "Solstice Fitness Club",
      "timestamp": "2026-02-23T05:33:00.886Z",
      "reference": "REF-70DNSN"
    },
    {
      "id": "txn_8f248abeccba6fd45df91c36",
      "amount": 1,
      "currency": "JPY",
      "type": "payment",
      "status": "completed",
      "description": "Payment to Brightcart Market",
      "merchant": "Brightcart Market",
      "timestamp": "2026-02-09T18:53:40.283Z",
      "reference": "REF-ORH7T9"
    },
    {
      "id": "txn_790902c05ac838fecf0b9c41",
      "amount": 71,
      "currency": "JPY",
      "type": "payment",
      "status": "completed",
      "description": "Payment to Northwind Apparel",
      "merchant": "Northwind Apparel",
      "timestamp": "2026-02-01T03:39:25.625Z",
      "reference": "REF-OO8VNR"
    },
    {
      "id": "txn_2fda52e1ef2ffb70a746915c",
      "amount": 1710,
      "currency": "JPY",
      "type": "payment",
    …
    "generatedAt": "2026-07-29T08:13:22.000Z"
  }
}

Failed transactions for error-state UIs /api/transactions?status=failed&count=5&seed=7

GET /api/transactions?status=failed&count=5&seed=7

{
  "data": [
    {
      "id": "txn_c7e2436f61bcde1a237f61fd",
      "amount": 1593.19,
      "currency": "USD",
      "type": "transfer",
      "status": "failed",
      "description": "Transfer to Granite Trust Savings",
      "merchant": "Granite Trust Savings",
      "timestamp": "2026-05-16T23:26:36.670Z",
      "reference": "REF-VNLT2B"
    },
    {
      "id": "txn_0ed5cab8a9dd45683e96ae0b",
      "amount": 572.5,
      "currency": "USD",
      "type": "transfer",
      "status": "failed",
      "description": "Transfer to Sterling Investment Fund",
      "merchant": "Sterling Investment Fund",
      "timestamp": "2026-07-10T16:44:42.283Z",
      "reference": "REF-1TTUKI"
    },
    {
      "id": "txn_01cdce3b5a6e1db3ad9ee1bc",
      "amount": 2038.35,
      "currency": "USD",
      "type": "refund",
      "status": "failed",
      "description": "Refund from Maple & Main Diner",
      "merchant": "Maple & Main Diner",
      "timestamp": "2026-07-07T08:05:23.253Z",
      "reference": "REF-FC6XF3"
    },
    {
      "id": "txn_46a2bfcd9982cf8a877eee4e",
      "amount": 1405.21,
      "currency": "USD",
      "type": "deposit",
    …
    "generatedAt": "2026-07-29T08:13:22.000Z"
  }
}

About this API

Coverage, behavior and common use cases

Coverage & behavior

Generates a plausible payment ledger. Every record is fake — no real accounts, merchants or money — but internally coherent: the description always names the record's actual merchant with a verb matching its type ("Payment to …", "Refund from …", "Withdrawal at …"), and each type draws from its own realistic counterparty pool — stores and services for payments/refunds, accounts for transfers, payroll and clients for deposits, ATMs and branches for withdrawals.

Every filter genuinely constrains the output:

minAmount/maxAmount bound every amount (inclusive), and amounts always carry the currency's ISO 4217 minor unit: JPY/KRW give whole numbers, KWD up to three decimals, everything else two. Amounts lean toward the lower end of the range, like real ledgers. Impossible combinations fail loudly — minAmount above maxAmount, an unknown currency, or a range so narrow no representable amount exists (e.g. currency=JPY&minAmount=0.2&maxAmount=0.8) each return a 400 explaining the problem.
type pins every record to one of payment / refund / transfer / deposit / withdrawal; omitted, you get a weighted mix with payments most common.
status pins the status; omitted, statuses follow a realistic split: 80% completed, 12% pending, 8% failed.
from/to bound every timestamp (inclusive); by default you get the past 90 days. Date-only values mean midnight UTC, and from > to is a 400.

id (txn_ + 24 hex) and reference (REF- + 6 alphanumerics) look like real payment-processor identifiers, and with a seed the same request returns byte-identical transactions forever.

Use it for

Seed banking, budgeting or expense-tracker demos with months of plausible ledger history
Test list UIs — filters, pagination, running totals, CSV export — against a realistic transaction feed
Reproducible payment fixtures in CI via seed, including JPY/KWD decimal edge cases

Frequently asked questions

Practical answers about this endpoint 3

Do amounts and dates respect my bounds?

Yes — minAmount/maxAmount and from/to genuinely constrain every record; that's contract-tested, not decorative.

Are seeded results stable during the day?

Yes — the default date window snaps to UTC midnight, so the same seed returns identical transactions all day (a drift bug we explicitly engineered away).

What do records include?

Id, amount with ISO currency, type, status, description, merchant and an ISO 8601 timestamp — a checkout table in one call.

Standards & references

Primary sources behind the contract

ISO 4217 currency codes

Useful next tools in the catalog

Test Credit Card Number API MOCK DATA

Clearly-fake test credit cards — Luhn-valid numbers with correct Visa, Mastercard, Amex and Discover prefixes, future expiry and matching CVV.

Synthetic IBAN Test Data API MOCK DATA

Generate synthetic IBAN-shaped values for 20 countries with matching length, broad BBAN character classes and international MOD-97, or inspect the same checks.

Fake Invoice Data API MOCK DATA

Exact fake invoices with line items, ISO currency precision, tax, collectible balances and status-consistent issue, due and payment dates.

Fake Subscription Data API MOCK DATA

Fake SaaS subscriptions with exact currency precision, calendar billing periods and explicit trial, renewal, pause and cancellation state masks.

ISO 4217 Currency Codes API REAL DATA

Every active ISO 4217 currency — code, name, symbol, minor-unit decimals and the countries using it. Search the list or look up one code, with honest 404s.

Double-Entry Ledger & Journal Entry API MOCK DATA

Double-entry journal entries where every entry balances to zero, per-account running balances are exact, and the trial balance always sums to zero.