Demo Endpoints

Unauthenticated playground endpoints for trying Golden Suite tools.

Demo Endpoints

The demo endpoints provide an unauthenticated playground for trying Golden Suite tools without signing up. All demo data is ephemeral and scoped to a session.

Upload a file and run a Golden Suite tool against it. Returns a session ID for subsequent operations.

Request

Multipart form data:

Field	Type	Required	Description
`file`	file	Yes	CSV or Excel file to process
`tool`	string	Yes	Tool name to run (e.g. `goldencheck`, `goldenmatch`)

Response

{
  "session_id": "abc123",
  "row_count": 1500,
  "columns": ["id", "name", "email", "phone"]
}

Errors

Status	Meaning
`413 Payload Too Large`	File exceeds the upload size limit
`422 Unprocessable Entity`	Invalid file format or missing required field

Re-run matching with different parameters on an existing demo session.

Request

{
  "session_id": "abc123",
  "threshold": 0.75,
  "weights": {
    "name": 0.4,
    "email": 0.35,
    "phone": 0.25
  }
}

Field	Type	Required	Description
`session_id`	string	Yes	Session ID from a previous upload
`threshold`	number	Yes	Match confidence threshold (0.0 - 1.0)
`weights`	object	Yes	Field-level weights for scoring

Response

{
  "scored_pairs": 342,
  "cluster_count": 87,
  "execution_ms": 1240
}

Errors

Status	Meaning
`404 Not Found`	Session ID not found or expired
`422 Unprocessable Entity`	Invalid threshold or weights

Download the results of a demo session as a CSV file.

Request

Query parameters:

Param	Type	Required	Description
`session_id`	string	Yes	Session ID from a previous upload

curl "https://backend-production-5c86.up.railway.app/api/demo/download?session_id=abc123" \
  -o results.csv

Response

Returns a text/csv file with matched and scored records.

Errors

Status	Meaning
`404 Not Found`	Session ID not found or expired

← Authentication Sources →