---
title: "Linguistic syntax/grammar checker. Returns a structured analysis with overall score, per-issue breakdown by severity …"
method: POST
path: "/api/syntax-checker-agent"
tags: ["AI Agents"]
---

# Linguistic syntax/grammar checker. Returns a structured analysis with overall score, per-issue breakdown by severity …

`POST /api/syntax-checker-agent`

## Request

- Base URL: `https://platform.vocametrix.com`
- URL: `https://platform.vocametrix.com/api/syntax-checker-agent`
- Auth: API key in header `X-API-Key`

## Request body

- object
  - `text` string, required: REQUIRED. Text to analyze (≤ 5000 characters).
  - `locale` string, required: REQUIRED. Language code (validated via validateLanguageCode).
  - `threadId` string: Optional. Thread ID for multi-turn continuity.
  - `email` string: Optional. Used by the credit-validation flow.

## Response `200`

Successful response

- object
  - `success` boolean: Boolean.
  - `analysis` object: Object: { overall_score, language_detected, text_length, analysis_timestamp, issues: [...], suggestions: [{category, type, description, examples}], statistics: {total_issues, by_severity: {high, medium, low}, by_type: {grammar, spelling, punctuation, style, clarity}}, corrected_text, readability: {grade_level, reading_ease, avg_sentence_length} }.
  - `metadata` object: Object: { locale, textLength, threadId, agentName, processingTimeSeconds, timestamp }.
  - `remaining_credits` number: Number.

## Other responses

- `400`: Bad request — missing or invalid parameter
- `401`: Unauthorized — missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Server error

---

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