---
title: "Parse Natural Language"
method: POST
path: "/api/v1/nl/parse"
tags: ["Natural Language"]
---

# Parse Natural Language

`POST /api/v1/nl/parse`

## Request

- Base URL: `https://crashtestyourstrategy.com` (the document declares no server; this is the origin it was published from)
- URL: `https://crashtestyourstrategy.com/api/v1/nl/parse`
- Auth: none declared

Parse natural language strategy description into structured strategy JSON.

## Query parameters

- `user_id` integer

## Request body

- NLParseRequest: Request to parse natural language strategy.
  - `text` string, required
  - `debug` boolean: Include detailed debug information in response

## Response `200`

Successful Response

- NLParseResponse: Response from NL parsing.
  - `strategy_json` object, required
  - `explanation` string, required
  - `confidence` number, required
  - `formalizable_percentage` number, nullable: Percentage of conditions that were legally formalizable (0-100)
  - `parse_status` string, nullable: Parse status: 'full', 'partial', or 'failed'
  - `unparseable_concepts` string[], nullable: Concepts detected in input that could not be formalized
  - `assumptions` string[], nullable: Interpretive decisions made by the parser (shown to user in report)
  - `debug` object, nullable: Debug info (only present if debug=True in request)

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/crashtestyourstrategy/apis/crashtestyourstrategy-api.md) · [All operations](https://skmtc.dev/crashtestyourstrategy/apis/crashtestyourstrategy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crashtestyourstrategy/apis/crashtestyourstrategy-api/revisions/a4751a2748fd?raw)