Generate synthetic finance data

curl --request POST \
  --url https://apix.spotzee.com/api/ext/generic/data/generate/finance \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data count=10 \
  --data locale=en \
  --data seed=12345 \
  --data method=profile \
  --data accountNumberLength=8 \
  --data amountMin=0 \
  --data amountMax=1000 \
  --data amountDecimalPlaces=2 \
  --data 'amountSymbol=$' \
  --data amountAutoFormat=false \
  --data bicIncludeBranchCode=false \
  --data bitcoinAddressType=bech32 \
  --data bitcoinNetwork=testnet \
  --data creditCardIssuer=visa \
  --data ibanFormatted=false \
  --data ibanCountryCode=DE \
  --data maskedNumberLength=4 \
  --data maskedNumberParens=true \
  --data maskedNumberEllipsis=true \
  --data pinLength=4

import requests

url = "https://apix.spotzee.com/api/ext/generic/data/generate/finance"

payload = {
    "count": "10",
    "locale": "en",
    "seed": "12345",
    "method": "profile",
    "accountNumberLength": "8",
    "amountMin": "0",
    "amountMax": "1000",
    "amountDecimalPlaces": "2",
    "amountSymbol": "$",
    "amountAutoFormat": "false",
    "bicIncludeBranchCode": "false",
    "bitcoinAddressType": "bech32",
    "bitcoinNetwork": "testnet",
    "creditCardIssuer": "visa",
    "ibanFormatted": "false",
    "ibanCountryCode": "DE",
    "maskedNumberLength": "4",
    "maskedNumberParens": "true",
    "maskedNumberEllipsis": "true",
    "pinLength": "4"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/x-www-form-urlencoded"
}

response = requests.post(url, data=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/x-www-form-urlencoded'
  },
  body: new URLSearchParams({
    count: '10',
    locale: 'en',
    seed: '12345',
    method: 'profile',
    accountNumberLength: '8',
    amountMin: '0',
    amountMax: '1000',
    amountDecimalPlaces: '2',
    amountSymbol: '$',
    amountAutoFormat: 'false',
    bicIncludeBranchCode: 'false',
    bitcoinAddressType: 'bech32',
    bitcoinNetwork: 'testnet',
    creditCardIssuer: 'visa',
    ibanFormatted: 'false',
    ibanCountryCode: 'DE',
    maskedNumberLength: '4',
    maskedNumberParens: 'true',
    maskedNumberEllipsis: 'true',
    pinLength: '4'
  })
};

fetch('https://apix.spotzee.com/api/ext/generic/data/generate/finance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

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

func main() {

	url := "https://apix.spotzee.com/api/ext/generic/data/generate/finance"

	payload := strings.NewReader("count=10&locale=en&seed=12345&method=profile&accountNumberLength=8&amountMin=0&amountMax=1000&amountDecimalPlaces=2&amountSymbol=%24&amountAutoFormat=false&bicIncludeBranchCode=false&bitcoinAddressType=bech32&bitcoinNetwork=testnet&creditCardIssuer=visa&ibanFormatted=false&ibanCountryCode=DE&maskedNumberLength=4&maskedNumberParens=true&maskedNumberEllipsis=true&pinLength=4")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/x-www-form-urlencoded")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "status": "success",
  "data": {
    "finance": [
      {
        "method": "profile",
        "value": "Personal Loan Account",
        "accountName": "Personal Loan Account",
        "accountNumber": "92842238",
        "accountNumberLength": 8,
        "amount": "$617.87",
        "amountMin": 0,
        "amountMax": 1000,
        "amountDecimalPlaces": 2,
        "amountSymbol": "$",
        "amountAutoFormat": false,
        "currency": {
          "code": "USD",
          "name": "US Dollar",
          "symbol": "$",
          "numericCode": "840"
        },
        "currencyCode": "USD",
        "currencyName": "US Dollar",
        "currencyNumericCode": "840",
        "currencySymbol": "$",
        "bic": "WYAUPGX1",
        "bicIncludeBranchCode": false,
        "iban": "DE84 1022 7075 0900 1170 01",
        "ibanFormatted": true,
        "ibanCountryCode": "DE",
        "routingNumber": "522814402",
        "maskedNumber": "(...9711)",
        "maskedNumberLength": 4,
        "maskedNumberParens": true,
        "maskedNumberEllipsis": true,
        "transactionDescription": "payment transaction using a masked fixture for USD 617.87",
        "transactionType": "payment"
      }
    ],
    "generated": 1,
    "locale": "en",
    "seed": 12345,
    "method": "profile"
  },
  "performance": {
    "generationTime": 2,
    "itemsGenerated": 1,
    "locale": "en"
  }
}

{
  "status": "error",
  "error": "Invalid request parameters"
}

{
  "status": "error",
  "error": "Invalid request parameters"
}

{
  "status": "error",
  "error": "Invalid request parameters"
}

{
  "status": "error",
  "error": "Invalid request parameters"
}

{
  "status": "error",
  "error": "Invalid request parameters"
}

{
  "status": "error",
  "error": "Invalid request parameters"
}

Data

Generate synthetic finance data

Generates synthetic finance fixtures for testing account, payment, currency, transaction, blockchain-address, and card-validation workflows. Generated values are test fixtures only and are not usable financial credentials. Supported methods: profile, accountName, accountNumber, amount, bic, bitcoinAddress, creditCardCVV, creditCardIssuer, creditCardNumber, currency, currencyCode, currencyName, currencyNumericCode, currencySymbol, ethereumAddress, iban, litecoinAddress, maskedNumber, pin, routingNumber, transactionDescription, and transactionType.

POST

generic

data

generate

finance

Generate synthetic finance data

curl --request POST \
  --url https://apix.spotzee.com/api/ext/generic/data/generate/finance \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data count=10 \
  --data locale=en \
  --data seed=12345 \
  --data method=profile \
  --data accountNumberLength=8 \
  --data amountMin=0 \
  --data amountMax=1000 \
  --data amountDecimalPlaces=2 \
  --data 'amountSymbol=$' \
  --data amountAutoFormat=false \
  --data bicIncludeBranchCode=false \
  --data bitcoinAddressType=bech32 \
  --data bitcoinNetwork=testnet \
  --data creditCardIssuer=visa \
  --data ibanFormatted=false \
  --data ibanCountryCode=DE \
  --data maskedNumberLength=4 \
  --data maskedNumberParens=true \
  --data maskedNumberEllipsis=true \
  --data pinLength=4

import requests

url = "https://apix.spotzee.com/api/ext/generic/data/generate/finance"

payload = {
    "count": "10",
    "locale": "en",
    "seed": "12345",
    "method": "profile",
    "accountNumberLength": "8",
    "amountMin": "0",
    "amountMax": "1000",
    "amountDecimalPlaces": "2",
    "amountSymbol": "$",
    "amountAutoFormat": "false",
    "bicIncludeBranchCode": "false",
    "bitcoinAddressType": "bech32",
    "bitcoinNetwork": "testnet",
    "creditCardIssuer": "visa",
    "ibanFormatted": "false",
    "ibanCountryCode": "DE",
    "maskedNumberLength": "4",
    "maskedNumberParens": "true",
    "maskedNumberEllipsis": "true",
    "pinLength": "4"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/x-www-form-urlencoded"
}

response = requests.post(url, data=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/x-www-form-urlencoded'
  },
  body: new URLSearchParams({
    count: '10',
    locale: 'en',
    seed: '12345',
    method: 'profile',
    accountNumberLength: '8',
    amountMin: '0',
    amountMax: '1000',
    amountDecimalPlaces: '2',
    amountSymbol: '$',
    amountAutoFormat: 'false',
    bicIncludeBranchCode: 'false',
    bitcoinAddressType: 'bech32',
    bitcoinNetwork: 'testnet',
    creditCardIssuer: 'visa',
    ibanFormatted: 'false',
    ibanCountryCode: 'DE',
    maskedNumberLength: '4',
    maskedNumberParens: 'true',
    maskedNumberEllipsis: 'true',
    pinLength: '4'
  })
};

fetch('https://apix.spotzee.com/api/ext/generic/data/generate/finance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

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

func main() {

	url := "https://apix.spotzee.com/api/ext/generic/data/generate/finance"

	payload := strings.NewReader("count=10&locale=en&seed=12345&method=profile&accountNumberLength=8&amountMin=0&amountMax=1000&amountDecimalPlaces=2&amountSymbol=%24&amountAutoFormat=false&bicIncludeBranchCode=false&bitcoinAddressType=bech32&bitcoinNetwork=testnet&creditCardIssuer=visa&ibanFormatted=false&ibanCountryCode=DE&maskedNumberLength=4&maskedNumberParens=true&maskedNumberEllipsis=true&pinLength=4")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/x-www-form-urlencoded")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "status": "success",
  "data": {
    "finance": [
      {
        "method": "profile",
        "value": "Personal Loan Account",
        "accountName": "Personal Loan Account",
        "accountNumber": "92842238",
        "accountNumberLength": 8,
        "amount": "$617.87",
        "amountMin": 0,
        "amountMax": 1000,
        "amountDecimalPlaces": 2,
        "amountSymbol": "$",
        "amountAutoFormat": false,
        "currency": {
          "code": "USD",
          "name": "US Dollar",
          "symbol": "$",
          "numericCode": "840"
        },
        "currencyCode": "USD",
        "currencyName": "US Dollar",
        "currencyNumericCode": "840",
        "currencySymbol": "$",
        "bic": "WYAUPGX1",
        "bicIncludeBranchCode": false,
        "iban": "DE84 1022 7075 0900 1170 01",
        "ibanFormatted": true,
        "ibanCountryCode": "DE",
        "routingNumber": "522814402",
        "maskedNumber": "(...9711)",
        "maskedNumberLength": 4,
        "maskedNumberParens": true,
        "maskedNumberEllipsis": true,
        "transactionDescription": "payment transaction using a masked fixture for USD 617.87",
        "transactionType": "payment"
      }
    ],
    "generated": 1,
    "locale": "en",
    "seed": 12345,
    "method": "profile"
  },
  "performance": {
    "generationTime": 2,
    "itemsGenerated": 1,
    "locale": "en"
  }
}

{
  "status": "error",
  "error": "Invalid request parameters"
}

{
  "status": "error",
  "error": "Invalid request parameters"
}

{
  "status": "error",
  "error": "Invalid request parameters"
}

{
  "status": "error",
  "error": "Invalid request parameters"
}

{
  "status": "error",
  "error": "Invalid request parameters"
}

{
  "status": "error",
  "error": "Invalid request parameters"
}

Authorizations

Authorization

string

header

required

Bearer token authentication. Use format: Bearer YOUR_API_KEY

Body

application/x-www-form-urlencoded

count

string

Number of finance records to generate (1-100). Passed as string but must be numeric.

Pattern: ^[1-9]\d?$|^100$

Example:

"10"

locale

string

Locale for generated data (e.g., en, es, fr, de, pt_BR, zh_CN)

Example:

"en"

seed

string

Seed for deterministic generation. Same seed produces same results.

Example:

"12345"

method

enum<string>

Finance generation method. Defaults to profile.

Available options:

profile,

accountName,

accountNumber,

amount,

bic,

bitcoinAddress,

creditCardCVV,

creditCardIssuer,

creditCardNumber,

currency,

currencyCode,

currencyName,

currencyNumericCode,

currencySymbol,

ethereumAddress,

iban,

litecoinAddress,

maskedNumber,

pin,

routingNumber,

transactionDescription,

transactionType

Example:

"profile"

accountNumberLength

string

Generated account-number length. Defaults to 8.

Pattern: ^[1-9]\d*$

Example:

"8"

amountMin

string

Minimum generated amount when method=amount or profile. Defaults to 0.

Pattern: ^-?(?:\d+|\d*\.\d+)$

Example:

"0"

amountMax

string

Maximum generated amount when method=amount or profile. Defaults to 1000.

Pattern: ^-?(?:\d+|\d*\.\d+)$

Example:

"1000"

amountDecimalPlaces

string

Number of decimal places for generated amounts when method=amount or profile. Defaults to 2.

Pattern: ^\d+$

Example:

"2"

amountSymbol

string

Optional currency symbol or prefix for generated amounts. Maximum 8 characters.

Maximum string length: 8

Example:

"$"

amountAutoFormat

enum<string>

Use locale-aware amount formatting when supported.

Available options:

true,

false

Example:

"false"

bicIncludeBranchCode

enum<string>

Include a branch code on generated BIC values.

Available options:

true,

false

Example:

"false"

bitcoinAddressType

enum<string>

Bitcoin address family when method=bitcoinAddress.

Available options:

legacy,

segwit,

bech32,

taproot

Example:

"bech32"

bitcoinNetwork

enum<string>

Bitcoin network when method=bitcoinAddress. Defaults to mainnet.

Available options:

mainnet,

testnet

Example:

"testnet"

creditCardIssuer

string

Optional card issuer or safe fixture format when method=creditCardNumber. Maximum 64 printable ASCII characters.

Maximum string length: 64

Example:

"visa"

ibanFormatted

enum<string>

Return formatted IBAN output when method=iban or profile.

Available options:

true,

false

Example:

"false"

ibanCountryCode

string

Optional two-letter uppercase country code for generated IBAN values.

Pattern: ^[A-Z]{2}$

Example:

"DE"

maskedNumberLength

string

Length of the unmasked suffix for generated masked numbers. Defaults to 4.

Pattern: ^[1-9]\d*$

Example:

"4"

maskedNumberParens

enum<string>

Wrap generated masked numbers in parentheses.

Available options:

true,

false

Example:

"true"

maskedNumberEllipsis

enum<string>

Prefix generated masked numbers with an ellipsis.

Available options:

true,

false

Example:

"true"

pinLength

string

Generated PIN length. Defaults to 4.

Pattern: ^[1-9]\d*$

Example:

"4"

Response

Successfully generated finance data

status

enum<string>

required

Available options:

success

data

object

required

Hide child attributes

data.finance

object[]

required

Hide child attributes

data.finance.method

enum<string>

required

Resolved finance generation method.

Available options:

profile,

accountName,

accountNumber,

amount,

bic,

bitcoinAddress,

creditCardCVV,

creditCardIssuer,

creditCardNumber,

currency,

currencyCode,

currencyName,

currencyNumericCode,

currencySymbol,

ethereumAddress,

iban,

litecoinAddress,

maskedNumber,

pin,

routingNumber,

transactionDescription,

transactionType

Example:

"profile"

data.finance.value

string

required

Primary generated finance fixture value.

Example:

"Personal Loan Account"

data.finance.accountName

string

Generated account name fixture.

Example:

"Personal Loan Account"

data.finance.accountNumber

string

Generated account number fixture.

Example:

"92842238"

data.finance.accountNumberLength

number

Resolved account-number length.

Example:

8

data.finance.amount

string

Generated amount fixture.

Example:

"$617.87"

data.finance.amountMin

number

Resolved minimum amount.

Example:

0

data.finance.amountMax

number

Resolved maximum amount.

Example:

1000

data.finance.amountDecimalPlaces

number

Resolved amount decimal places.

Example:

2

data.finance.amountSymbol

string

Resolved amount symbol.

Example:

"$"

data.finance.amountAutoFormat

boolean

Resolved amount auto-format flag.

Example:

false

data.finance.bic

string

Generated BIC/SWIFT fixture.

Example:

"WYAUPGX1"

data.finance.bicIncludeBranchCode

boolean

Resolved BIC branch-code flag.

Example:

false

data.finance.bitcoinAddress

string

Generated Bitcoin address fixture.

Example:

"bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4"

data.finance.bitcoinAddressType

enum<string>

Resolved Bitcoin address family.

Available options:

legacy,

segwit,

bech32,

taproot

Example:

"bech32"

data.finance.bitcoinNetwork

enum<string>

Resolved Bitcoin network.

Available options:

mainnet,

testnet

Example:

"testnet"

data.finance.creditCardCVV

string

Generated card verification fixture.

Example:

"506"

data.finance.creditCardIssuer

string

Generated or requested card issuer fixture.

Example:

"visa"

data.finance.creditCardNumber

string

Generated card-number fixture for validation testing.

Example:

"4882664999007"

data.finance.currency

object

Hide child attributes

data.finance.currency.code

string

required

Generated currency code.

Example:

"USD"

data.finance.currency.name

string

required

Generated currency name.

Example:

"US Dollar"

data.finance.currency.symbol

string

required

Generated currency symbol.

Example:

"$"

data.finance.currency.numericCode

string

Generated ISO 4217 numeric currency code.

Example:

"840"

data.finance.currencyCode

string

Generated currency code.

Example:

"USD"

data.finance.currencyName

string

Generated currency name.

Example:

"US Dollar"

data.finance.currencyNumericCode

string

Generated ISO 4217 numeric currency code.

Example:

"840"

data.finance.currencySymbol

string

Generated currency symbol.

Example:

"$"

data.finance.ethereumAddress

string

Generated Ethereum address fixture.

Example:

"0xf03dfeecbafc5147241cc4c4ca20b3c9dfd04c4a"

data.finance.iban

string

Generated IBAN fixture.

Example:

"DE84 1022 7075 0900 1170 01"

data.finance.ibanFormatted

boolean

Resolved IBAN formatting flag.

Example:

true

data.finance.ibanCountryCode

string

Resolved IBAN country code.

Example:

"DE"

data.finance.litecoinAddress

string

Generated Litecoin address fixture.

Example:

"MoQaSTGWBRXkWfyxKbNKuPrAWGELzcW"

data.finance.maskedNumber

string

Generated masked number fixture.

Example:

"(...9711)"

data.finance.maskedNumberLength

number

Resolved masked-number suffix length.

Example:

4

data.finance.maskedNumberParens

boolean

Resolved masked-number parentheses flag.

Example:

true

data.finance.maskedNumberEllipsis

boolean

Resolved masked-number ellipsis flag.

Example:

true

data.finance.pin

string

Generated PIN fixture.

Example:

"5067"

data.finance.pinLength

number

Resolved PIN length.

Example:

4

data.finance.routingNumber

string

Generated routing number fixture.

Example:

"522814402"

data.finance.transactionDescription

string

Generated transaction description fixture.

Example:

"payment transaction using card ending with a masked fixture for USD 617.87"

data.finance.transactionType

string

Generated transaction type fixture.

Example:

"payment"

data.generated

number

required

data.locale

string

required

data.method

enum<string>

required

Available options:

profile,

accountName,

accountNumber,

amount,

bic,

bitcoinAddress,

creditCardCVV,

creditCardIssuer,

creditCardNumber,

currency,

currencyCode,

currencyName,

currencyNumericCode,

currencySymbol,

ethereumAddress,

iban,

litecoinAddress,

maskedNumber,

pin,

routingNumber,

transactionDescription,

transactionType

data.seed

number

performance

object

Hide child attributes

performance.generationTime

number

required

Generation time in milliseconds.

Example:

2

performance.itemsGenerated

number

required

Number of items generated.

Example:

10

performance.locale

string

required

Locale used for generation.

Example:

"en"

Overview

AI

Text

DNS

Email

SMS

Data

Generate synthetic finance data

Authorizations

Body

Response