{"openapi":"3.1.0","info":{"title":"Apizie","version":"2.0.0","description":"One API key, one envelope, many public data sources. Success responses include a `source` block to cite. Apizie Finance endpoints (SEC EDGAR, FRED, ECB, U.S. Treasury, GLEIF, World Bank, official:*) need a Finance plan."},"servers":[{"url":"https://apizie.tech"}],"security":[{"ApiKeyAuth":[]}],"paths":{"/v1/security:langfuse/dataset-items-create":{"post":{"operationId":"security_langfuse_dataset_items_create","summary":"Create a dataset item","description":"POST /api/public/dataset-items","tags":["security"],"x-apizie-access":"write","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["body"],"properties":{"body":{"type":"object","description":"JSON request body"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/security:langfuse/dataset-items-get":{"get":{"operationId":"security_langfuse_dataset_items_get","summary":"Get a dataset item","description":"GET /api/public/dataset-items/{id}","tags":["security"],"x-apizie-access":"read","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/security:langfuse/dataset-run-items-create":{"post":{"operationId":"security_langfuse_dataset_run_items_create","summary":"Create a dataset run item","description":"POST /api/public/dataset-run-items","tags":["security"],"x-apizie-access":"write","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["body"],"properties":{"body":{"type":"object","description":"JSON request body"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/security:langfuse/datasets-list":{"get":{"operationId":"security_langfuse_datasets_list","summary":"Get all datasets","description":"GET /api/public/datasets","tags":["security"],"x-apizie-access":"read","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/security:langfuse/datasets-create":{"post":{"operationId":"security_langfuse_datasets_create","summary":"Create a dataset","description":"POST /api/public/datasets","tags":["security"],"x-apizie-access":"write","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["body"],"properties":{"body":{"type":"object","description":"JSON request body"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/security:langfuse/datasets-get":{"get":{"operationId":"security_langfuse_datasets_get","summary":"Get a dataset and its items","description":"GET /api/public/datasets/{datasetName}","tags":["security"],"x-apizie-access":"read","parameters":[{"name":"datasetName","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/security:langfuse/datasets-get-runs":{"get":{"operationId":"security_langfuse_datasets_get_runs","summary":"Get a dataset run and its items","description":"GET /api/public/datasets/{datasetName}/runs/{runName}","tags":["security"],"x-apizie-access":"read","parameters":[{"name":"datasetName","in":"query","required":true,"schema":{"type":"string"}},{"name":"runName","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/security:langfuse/health-health":{"get":{"operationId":"security_langfuse_health_health","summary":"Check health of API and database","description":"GET /api/public/health","tags":["security"],"x-apizie-access":"read","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/security:langfuse/ingestion-batch":{"post":{"operationId":"security_langfuse_ingestion_batch","summary":"Batched ingestion for Langfuse Tracing","description":"POST /api/public/ingestion","tags":["security"],"x-apizie-access":"write","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["body"],"properties":{"body":{"type":"object","description":"JSON request body"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/security:langfuse/metrics-daily":{"get":{"operationId":"security_langfuse_metrics_daily","summary":"Get daily metrics of the Langfuse project","description":"GET /api/public/metrics/daily","tags":["security"],"x-apizie-access":"read","parameters":[{"name":"page","in":"query","required":false,"description":"page number, starts at 1","schema":{"type":"integer","description":"page number, starts at 1"}},{"name":"limit","in":"query","required":false,"description":"limit of items per page","schema":{"type":"integer","description":"limit of items per page"}},{"name":"traceName","in":"query","required":false,"description":"Optional filter by the name of the trace","schema":{"type":"string","description":"Optional filter by the name of the trace"}},{"name":"userId","in":"query","required":false,"description":"Optional filter by the userId associated with the trace","schema":{"type":"string","description":"Optional filter by the userId associated with the trace"}},{"name":"tags","in":"query","required":false,"description":"Optional filter for metrics where traces include all of these tags","schema":{"type":"array","description":"Optional filter for metrics where traces include all of these tags"}},{"name":"fromTimestamp","in":"query","required":false,"description":"Optional filter to only include traces on or after a certain timestamp","schema":{"type":"string","description":"Optional filter to only include traces on or after a certain timestamp"}},{"name":"toTimestamp","in":"query","required":false,"description":"Optional filter to only include traces before a certain timestamp","schema":{"type":"string","description":"Optional filter to only include traces before a certain timestamp"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/security:langfuse/observations-get":{"get":{"operationId":"security_langfuse_observations_get","summary":"Get a observation","description":"GET /api/public/observations/{observationId}","tags":["security"],"x-apizie-access":"read","parameters":[{"name":"observationId","in":"query","required":true,"description":"The unique langfuse identifier of an observation, can be an event, span or generation","schema":{"type":"string","description":"The unique langfuse identifier of an observation, can be an event, span or generation"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/security:langfuse/observations-get-many":{"get":{"operationId":"security_langfuse_observations_get_many","summary":"Get a list of observations","description":"GET /api/public/observations","tags":["security"],"x-apizie-access":"read","parameters":[{"name":"page","in":"query","required":false,"description":"page number, starts at 1","schema":{"type":"integer","description":"page number, starts at 1"}},{"name":"limit","in":"query","required":false,"description":"limit of items per page","schema":{"type":"integer","description":"limit of items per page"}},{"name":"name","in":"query","required":false,"schema":{"type":"string"}},{"name":"userId","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}},{"name":"traceId","in":"query","required":false,"schema":{"type":"string"}},{"name":"parentObservationId","in":"query","required":false,"schema":{"type":"string"}},{"name":"fromStartTime","in":"query","required":false,"description":"Retrieve only observations with a start_time greater than this timestamp.","schema":{"type":"string","description":"Retrieve only observations with a start_time greater than this timestamp."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/security:langfuse/projects-get":{"get":{"operationId":"security_langfuse_projects_get","summary":"Get Project associated with API key","description":"GET /api/public/projects","tags":["security"],"x-apizie-access":"read","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/security:langfuse/prompts-get":{"get":{"operationId":"security_langfuse_prompts_get","summary":"Get a prompt","description":"GET /api/public/prompts","tags":["security"],"x-apizie-access":"read","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"}},{"name":"version","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/security:langfuse/prompts-create":{"post":{"operationId":"security_langfuse_prompts_create","summary":"Create a prompt","description":"POST /api/public/prompts","tags":["security"],"x-apizie-access":"write","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["body"],"properties":{"body":{"type":"object","description":"JSON request body"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/security:langfuse/score-get":{"get":{"operationId":"security_langfuse_score_get","summary":"Get a list of scores","description":"GET /api/public/scores","tags":["security"],"x-apizie-access":"read","parameters":[{"name":"page","in":"query","required":false,"description":"page number, starts at 1","schema":{"type":"integer","description":"page number, starts at 1"}},{"name":"limit","in":"query","required":false,"description":"limit of items per page","schema":{"type":"integer","description":"limit of items per page"}},{"name":"userId","in":"query","required":false,"schema":{"type":"string"}},{"name":"name","in":"query","required":false,"schema":{"type":"string"}},{"name":"fromTimestamp","in":"query","required":false,"description":"Retrieve only scores newer than this timestamp.","schema":{"type":"string","description":"Retrieve only scores newer than this timestamp."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/security:langfuse/score-create":{"post":{"operationId":"security_langfuse_score_create","summary":"Create a score","description":"POST /api/public/scores","tags":["security"],"x-apizie-access":"write","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["body"],"properties":{"body":{"type":"object","description":"JSON request body"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/security:langfuse/score-get-by-id":{"get":{"operationId":"security_langfuse_score_get_by_id","summary":"Get a score","description":"GET /api/public/scores/{scoreId}","tags":["security"],"x-apizie-access":"read","parameters":[{"name":"scoreId","in":"query","required":true,"description":"The unique langfuse identifier of a score","schema":{"type":"string","description":"The unique langfuse identifier of a score"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/security:langfuse/score-delete":{"post":{"operationId":"security_langfuse_score_delete","summary":"Delete a score","description":"DELETE /api/public/scores/{scoreId}","tags":["security"],"x-apizie-access":"write","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["scoreId"],"properties":{"scoreId":{"type":"string","description":"The unique langfuse identifier of a score"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/security:langfuse/sessions-get":{"get":{"operationId":"security_langfuse_sessions_get","summary":"Get a session","description":"GET /api/public/sessions/{sessionId}","tags":["security"],"x-apizie-access":"read","parameters":[{"name":"sessionId","in":"query","required":true,"description":"The unique id of a session","schema":{"type":"string","description":"The unique id of a session"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/security:langfuse/trace-get":{"get":{"operationId":"security_langfuse_trace_get","summary":"Get a specific trace","description":"GET /api/public/traces/{traceId}","tags":["security"],"x-apizie-access":"read","parameters":[{"name":"traceId","in":"query","required":true,"description":"The unique langfuse identifier of a trace","schema":{"type":"string","description":"The unique langfuse identifier of a trace"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/security:langfuse/trace-list":{"get":{"operationId":"security_langfuse_trace_list","summary":"Get list of traces","description":"GET /api/public/traces","tags":["security"],"x-apizie-access":"read","parameters":[{"name":"page","in":"query","required":false,"description":"page number, starts at 1","schema":{"type":"integer","description":"page number, starts at 1"}},{"name":"limit","in":"query","required":false,"description":"limit of items per page","schema":{"type":"integer","description":"limit of items per page"}},{"name":"userId","in":"query","required":false,"schema":{"type":"string"}},{"name":"name","in":"query","required":false,"schema":{"type":"string"}},{"name":"fromTimestamp","in":"query","required":false,"description":"Retrieve only traces newer than this timestamp.","schema":{"type":"string","description":"Retrieve only traces newer than this timestamp."}},{"name":"orderBy","in":"query","required":false,"description":"Format of the string [field].[asc/desc]. Fields: id, timestamp, name, userId, release, version, public, bookmarked, sessionId. Example:…","schema":{"type":"string","description":"Format of the string [field].[asc/desc]. Fields: id, timestamp, name, userId, release, version, public, bookmarked, sessionId. Example:…"}},{"name":"tags","in":"query","required":false,"description":"Only traces that include all of these tags will be returned.","schema":{"type":"array","description":"Only traces that include all of these tags will be returned."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"RunEnvelope":{"type":"object","required":["project","data","timestamp"],"properties":{"project":{"type":"string","example":"official:company"},"data":{},"source":{"type":"object","description":"Where the data came from. Cite it.","properties":{"official":{"type":"boolean"},"provider":{"type":"string","example":"SEC EDGAR"},"publisher":{"type":"string","example":"U.S. Securities and Exchange Commission"},"url":{"type":"string","format":"uri","description":"A page a person can open to check the value"},"apiUrl":{"type":"string","format":"uri","description":"The official API URL that was called (credentials removed)"},"retrievedAt":{"type":"string","format":"date-time"},"license":{"type":"string"},"licenseUrl":{"type":"string","format":"uri"},"attribution":{"type":"string"},"notice":{"type":"string"}}},"timestamp":{"type":"string","format":"date-time"}}},"ErrorEnvelope":{"type":"object","properties":{"content":{},"message":{"type":"string"},"errors":{"type":"array","items":{}},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"responses":{"Error":{"description":"Invalid key, plan gate, rate limit or upstream failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}