---
title: "Extract Facts"
method: POST
path: "/tools/extract-facts"
tags: ["Facts"]
---

# Extract Facts

`POST /tools/extract-facts`

Extract facts from provided text, without storing them.

## Headers

- `Tenant-Name` string, required — Identifies a distinct entity within Corti's multi-tenant system. Ensures correct routing and authentication of the request.

## Request body

- FactsExtractRequest
  - `context` CommonTextContext[], required
    - `type` 'text', required — The type of context, always "text" in this context.
    - `text` string, required — A text string to be used as input to the model.
  - `outputLanguage` string, required — The desired output language code for extracted facts. Check [languages page](/stt/languages) for more.

## Response `200`

Returns the extracted facts.

- FactsExtractResponse
  - `facts` object[], required — List of extracted facts based on the provided input context.
    - `group` string, required — The fact group key the fact belongs to.
    - `value` string, required — (deprecated) An individual, atomic fact.
    - `text` string, required — An individual, atomic fact.
  - `outputLanguage` string, required — The language locale of the output.
  - `usageInfo` CommonUsageInfo, required — Credits consumed for this request.
    - `creditsConsumed` number, required

## Other responses

- `504` — RFC9457

---

[API](https://skmtc.net/corti/apis/admin-api.md) · [All operations](https://skmtc.net/corti/apis/admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/corti/admin-api/versions/5d1895a1b3fc/schema)