Simulacra Headless API
API version: v1

Synthetic data generation for scenario modeling

Simulacra’s API lets enterprise research teams, agencies, and platform partners expand, rebalance, and scenario-condition completed survey datasets inside their own systems. Use measured-variable synthetic augmentation to stabilize small cells, model explicit what-if scenarios, and operationalize research workflows at scale.

Security

Bearer-token API, per-company approval, least-privilege service roles, idempotent writes, encrypted storage, and audited operational access.

Retention

Seed datasets and generated artifacts default to 24-hour retention, retrievable URLs are short-lived, and dataset retention cannot exceed 7 continuous days without a new upload.

Reliability

Async jobs, request IDs, and /healthz are documented in the API contract; contractual SLA terms layer on top of these platform defaults.

Support

Preserve X-Request-Id and response request_id values when contacting support. Never send bearer tokens or client secrets.

API entry points

PathDescription
/__docs__/Interactive reference, quickstarts, troubleshooting, and request samples.
/openapi.jsonOpenAPI 3.1 contract with stable operationIds and workflow links.
/llms.txtOperating notes for coding agents and generated-client workflows.
/errorsStable problem-code catalog with causes, fixes, and retry guidance.
/healthzLiveness probe for external monitoring.