dummydatagenpro API

The web app at dummydatagenpro.co.uk is a front end onto this API. Anything you can do there, a pipeline can do here.

Base URL: https://dummydatagenpro.co.uk/api

Authentication

Requests carry an API key in a header:

curl -H "X-API-Key: ddgp_your_key_here" \
  https://dummydatagenpro.co.uk/api/usage

Create and revoke keys from your account, or through the API itself:

Method	Path	Does
POST	/api-keys	Create a key. The value is returned once and never again.
GET	/api-keys	List your keys — metadata only, never the secret.
DELETE	/api-keys/{key_id}	Revoke a key.

Anonymous requests are allowed on the catalogue and health endpoints, and are rate limited more tightly than keyed ones.

Generating data

Generation is asynchronous: you post a request, get a job id back, poll it, then download. A large dataset takes longer than an HTTP request should wait, and the API is honest about that rather than holding a connection open.

Method	Path	Does
POST	/generate/custom	Generate from a column specification you supply
POST	/generate/schema	Generate from a schema — table definitions and their relationships
POST	/generate/jmeter	Generate a CSV shaped for a JMeter CSV Data Set Config

Each returns a job:

curl -X POST https://dummydatagenpro.co.uk/api/generate/custom \
  -H "X-API-Key: ddgp_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "rows": 10000, "format": "csv", "columns": [ ... ] }'

Tracking a job

Method	Path	Does
GET	/jobs/{job_id}	Status of one job
GET	/jobs/{job_id}/quality	Quality statistics for what it produced
GET	/jobs	List your jobs
DELETE	/jobs/{job_id}	Cancel a job that has not finished

Downloading

Method	Path	Does
GET	/download/{file_id}	Download a generated file from the catalogue
GET	/download/custom/{job_id}/{filename}	Download the output of one of your jobs

Catalogue

The pre-generated datasets the site offers, which need no generation step at all:

Method	Path	Does
GET	/catalog	List datasets, with filters
GET	/catalog/templates	Template names
GET	/catalog/templates/details	Templates with their columns and relationships
GET	/catalog/templates/related	Which templates join to which

Usage and quotas

Method	Path	Does
GET	/usage	Rows and requests used in the current period
GET	/usage/quotas	The limits for your tier

Health

Method	Path	Does
GET	/health	Service health
GET	/health/ecosystem	Health of the services it depends on

Limits

Quotas are per tier — free, Basic and Pro — and are enforced on rows generated as well as requests made. GET /usage/quotas returns yours rather than requiring you to read a pricing page. See dummydatagenpro for what each tier costs.