{"components":{"responses":{"Unauthorized":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Missing or invalid clientId"},"ValidationError":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Input validation failed"}},"schemas":{"ApiError":{"properties":{"apiVersion":{"type":"string"},"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"status":{"type":"integer"}},"type":"object"},"requestId":{"format":"uuid","type":"string"}},"type":"object"},"CollectionResponse":{"properties":{"apiVersion":{"type":"string"},"data":{"items":{},"type":"array"},"kind":{"type":"string"},"meta":{"nullable":true,"type":"object"},"pagination":{"$ref":"#/components/schemas/Pagination"},"requestId":{"format":"uuid","type":"string"},"timestamp":{"format":"int64","type":"integer"}},"required":["requestId","apiVersion","kind","data","pagination","timestamp"],"type":"object"},"Pagination":{"properties":{"count":{"type":"integer"},"hasMore":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"}},"type":"object"}}},"info":{"contact":{"url":"https://simpleidgen.com"},"description":"Enterprise-grade synthetic person data, calibrated against US public reference distributions (ACS, NHANES, CDC, KFF, BLS). Deterministic by seed, engine-versioned, with published fidelity reports.","title":"SimpleIDGen — Synthetic Data API","version":"2026-03-28"},"openapi":"3.0.3","paths":{"/audit/requests":{"post":{"operationId":"list_requests","requestBody":{"content":{"application/json":{"schema":{"properties":{"clientId":{"type":"string"},"requestId":{"format":"uuid","type":"string"}},"required":["clientId"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Request log collection"},"401":{"$ref":"#/components/responses/Unauthorized"}},"summary":"List your own API request logs"}},"/datasets/person":{"post":{"operationId":"submit_person_dataset","requestBody":{"content":{"application/json":{"schema":{"properties":{"clientId":{"type":"string"},"count":{"default":10000,"maximum":5000000,"minimum":1,"type":"integer"},"idFormat":{"default":"ulid","type":"string"},"locale":{"default":"en-US","type":"string"},"preset":{"type":"string"},"seed":{"format":"int64","type":"integer"}},"required":["clientId"],"type":"object"}}},"required":true},"responses":{"202":{"description":"Job submitted"},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"}},"summary":"Submit async person dataset job (up to 5M records, S3 output)"}},"/datasets/{jobId}":{"get":{"operationId":"get_dataset_job","parameters":[{"in":"path","name":"jobId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Job status with download URLs when completed"},"404":{"description":"Job not found"}},"summary":"Get dataset job status and download URLs"}},"/meta/openapi.json":{"get":{"operationId":"get_openapi","responses":{"200":{"description":"OpenAPI 3.0.3 spec"}},"summary":"This OpenAPI specification"}},"/meta/versions":{"get":{"operationId":"get_versions","responses":{"200":{"description":"Version info"}},"summary":"API version registry"}},"/mock/person":{"post":{"operationId":"mock_person","requestBody":{"content":{"application/json":{"schema":{"properties":{"clientId":{"type":"string"},"count":{"default":1,"maximum":100,"minimum":1,"type":"integer"},"idFormat":{"default":"ulid","enum":["ulid","uuidv7","uuid","nanoid","cuid2"],"type":"string"},"locale":{"default":"en-US","enum":["en-US","en-GB","en-IN"],"type":"string"},"preset":{"enum":["us_2024_adults","diabetic_seniors","prediabetic_adults","hypertensive_uncontrolled"],"type":"string"},"seed":{"format":"int64","type":"integer"},"stratification":{"description":"Per-attribute distribution overrides","type":"object"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}},"description":"Person collection"},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"}},"summary":"Generate synthetic person records (Person Profile Advanced engine v0.5)"}}},"servers":[{"description":"Versioned API root","url":"/v1"}]}