POST
/
v1
/
populations
{
  "data": {
    "id": "d670f351-8567-4586-9bba-b81add1bebe3",
    "avg_mean_absolute_error": 0.1472,
    "avg_mean_squared_error": 0.2311,
    "avg_normalised_kullback_leibler_divergence": 0.0063,
    "created_at": "2025-06-23T15:38:01Z",
    "description": "Baseline LLM population for mobility survey",
    "name": "Urban mobility survey",
    "public": true,
    "question_count": 42,
    "reality_target": "US commuters",
    "simulacrum_count": 5,
    "simulation_engine": "gpt-4o",
    "status": "Testing",
    "test_finished_at": "2023-11-07T05:31:56Z",
    "test_started_at": "2023-11-07T05:31:56Z",
    "upload_filename": "seed_data.csv"
  },
  "errors": [
    {
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

Headers

​
authorization
string

Body

multipart/form-data
​
population_options
object
required

Important: the API expects population_options to be sent as JSON string. Use json.dumps() to convert your object to string format for multipart/form-data requests.

​
seed_data
file
required
​
name
string
required
​
simulation_engine
string
required
​
description
string | null
​
reality_target
string | null
​
run_test
boolean | null
default:false

Response

Successful Response

​
data
object | null

The primary response payload. Contains the result of the request if successful. Population model data:

​
errors
ErrorResponse · object[] | null

List of structured error messages, if any occurred during the request.