Extract structured data | decision-machine-1 documentation

curl -X POST https://api.milliseconds.ai/v1/decision-machine-1/extract \
     -H "Content-Type: application/json" \
     -d '{
  "schema": {
    "properties": {
      "customer": {
        "description": "Company being billed",
        "type": "string"
      },
      "invoice_number": {
        "description": "The invoice identifier",
        "type": "string"
      },
      "net_terms_days": {
        "description": "Payment terms in days",
        "type": "integer"
      },
      "total_due": {
        "type": "number"
      }
    },
    "type": "object"
  },
  "text": "INVOICE #4471\nBilled to: Acme Corp\nInvoice date: 3 September 2026\nTotal due: $2,676.00\nPayment terms: Net 30"
}'

Fills a JSON Schema from the text. Supports strings, numbers, booleans, enums, string arrays and nested objects. Arrays of objects are accepted and returned empty. Missing values are null.

Send text for one result, or texts for a batch wrapped as { results: [...] }. The response carries x-input-chars (input characters) and x-input-tokens (input tokens billed for this call) headers.

Fills a JSON Schema from the text. Supports strings, numbers, booleans, enums, string arrays and nested objects. Arrays of objects are accepted and returned empty. Missing values are null. Send `text` for one result, or `texts` for a batch wrapped as `{ results: [...] }`. The response carries `x-input-chars` (input characters) and `x-input-tokens` (input tokens billed for this call) headers.

Request

This endpoint expects an object.

schemamap from strings to anyRequired

JSON Schema of the object to extract. Strings, numbers, booleans, enums, arrays of strings and nested objects. Arrays of objects are accepted and returned empty.

textstringOptional1-20000 characters

The text to decide about.

textslist of stringsOptional

Batch form: one result per text.

Response

Result, or { results } for a batch

ExtractResultobject

object

Errors

400

Bad Request Error

502

Bad Gateway Error