{"info":{"_postman_id":"638494df-edea-478f-8c6a-a481fb0ad6ec","name":"It's AI API","description":"

AI content detection, plagiarism and grammar checking API. One endpoint per scan type. Authenticate with Authorization: APIKey <your_key> header.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"33759613","collectionId":"638494df-edea-478f-8c6a-a481fb0ad6ec","publishedId":"2sBYArSrc8","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"6B84F0"},"publishDate":"2026-08-18T18:01:17.000Z"},"item":[{"name":"v2","item":[{"name":"Analyze text","id":"bba438bf-2338-4dec-ac05-c6029d35490e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/text","description":"

Submit a single text for AI detection analysis.

\n

Authenticate via Authorization: APIKey <your_key> header or api_key field in the request body.\nThe request is synchronous — it blocks until the analysis completes (up to 5 minutes).

\n
\n

Request fields

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeRequiredDescription
textstringyesThe text to analyze. Minimum 200 characters, maximum depends on your subscription plan.
api_keystringnoAPI key — alternative to the Authorization header.
\n
\n

Successful response (200)

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
scorefloatOverall AI detection score from 0.0 (human) to 1.0 (AI).
ai_percentagefloatFraction of text detected as AI-generated (0.0–1.0). Equals probabilities.ai + probabilities.ai_low.
probabilitiesobjectFraction of AI-generated vs human-written sentences in the text.
probabilities.aifloatFraction of sentences confidently classified as AI-generated (0.0–1.0).
probabilities.humanfloatFraction of sentences confidently classified as human-written (0.0–1.0).
probabilities.ai_lowfloatFraction of sentences with low-confidence AI classification (0.0–1.0).
probabilities.human_lowfloatFraction of sentences with low-confidence human classification (0.0–1.0).
segmentsfloat[]Per-sentence AI scores.
report_idstring (uuid)Report identifier. Download the PDF certificate at GET /api/report/download/{report_id}.
\n
\n

Error response

\n

All errors follow the same format:

\n
{\"status\": \"error\", \"error\": {\"code\": \"<type>:<code>\", \"message\": \"...\"}}\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
HTTP statusCodeWhen
403permission_denied:api_key_does_not_existThe API key is not recognised.
403not_authenticated:not_authenticatedNo API key was supplied.
403permission_denied:api_key_plan_incompatibleYour plan does not include API access.
403rich_limit:words_limit_reachedWord quota exhausted.
403rich_limit:text_exceeds_character_limitText exceeds the maximum length for your plan.
400validation:low_wordsText is shorter than 200 characters.
400validation:only_englishUnsupported language detected.
400validation:no_text_providedtext field is missing.
400validation:rate_limitRequests-per-second limit for your plan exceeded.
500server:service_unavailableInternal processing error or timeout.
\n
","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"638494df-edea-478f-8c6a-a481fb0ad6ec","id":"638494df-edea-478f-8c6a-a481fb0ad6ec","name":"It's AI API","type":"collection"}},"urlObject":{"path":["api","v2","text"],"host":["https://api.its-ai.org"],"query":[],"variable":[]}},"response":[{"id":"e858d888-c68a-4410-aa18-89616eeef4af","name":"200 OK","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/text"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"score\": 0.71,\n \"ai_percentage\": 0.24,\n \"probabilities\": {\n \"ai\": 0.11,\n \"ai_low\": 0.55,\n \"human\": 0.83,\n \"human_low\": 0.99\n },\n \"segments\": [\n 0.95,\n 0.35,\n 0.62,\n 0.48,\n 0.77,\n 0.21,\n 0.56,\n 0.68,\n 0.14,\n 0.83,\n 0.39,\n 0.72,\n 0.27,\n 0.91,\n 0.44,\n 0.66,\n 0.18,\n 0.52,\n 0.79,\n 0.31\n ],\n \"report_id\": \"00000000-0000-0000-0000-000000000000\"\n}"},{"id":"6a9bc147-d0dc-414b-8642-9684f40f8192","name":"400 Bad Request","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/text"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"validation:low_words\",\n \"message\": \"Try typing more text (>200 characters) so we can give you more accurate results\"\n }\n}"},{"id":"5a08d9ec-71da-44bb-92c4-09162d389e49","name":"403 Forbidden — unknown API key","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/text"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"permission_denied:api_key_does_not_exist\",\n \"message\": \"Invalid API key provided\"\n }\n}"},{"id":"37b2dbe8-b637-4308-ab9a-f39c2d02f50f","name":"403 Forbidden","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/text"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"rich_limit:words_limit_reached\",\n \"message\": \"Word limit reached\"\n }\n}"},{"id":"818b3a66-3e4e-4054-9de6-a7dab2ffe7ee","name":"400 Bad Request — rate limit","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/text"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"validation:rate_limit\",\n \"message\": \"Rate limit exceeded\"\n }\n}"},{"id":"06428bbf-3207-4676-8e1c-de20209b7528","name":"500 Internal Server Error","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/text"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"server:service_unavailable\",\n \"message\": \"Service is temporarily unavailable. Please, try again later\"\n }\n}"}],"_postman_id":"bba438bf-2338-4dec-ac05-c6029d35490e"},{"name":"Batch analyze texts","id":"56cd888d-c474-417b-adb0-96025d02fa3c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"texts\": [\n \"string\",\n \"string\"\n ],\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/batch","description":"

Submit multiple texts for AI detection analysis in a single request.

\n

Authenticate via Authorization: APIKey <your_key> header or api_key field in the request body.\nThe request is synchronous — it blocks until all analyses complete (up to 5 minutes).

\n

Invalid texts return per-item errors instead of failing the entire request.

\n
\n

Request fields

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeRequiredDescription
textsstring[]yesList of texts to analyze. Each text must be at least 200 characters and not exceed the maximum length for your plan.
api_keystringnoAPI key — alternative to the Authorization header.
\n

Batch size limit: 250 texts per request. That is the Enterprise allowance, and API keys are an Enterprise feature — the smaller per-plan batch limits (Pay as you go 1, Free 3, Plus 10, Premium 25, Pro 50) apply inside the web app, and are only reachable through the API by a key whose plan was downgraded, which the plan gate rejects first.

\n
\n

Successful response (200)

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
resultsobject[]Array of results, one per submitted text, in the same order.
results[].scorefloat|nullAI detection score (0.0–1.0). null if this text failed validation.
results[].ai_percentagefloat|nullAI-generated fraction (0.0–1.0). null if error.
results[].probabilitiesobject|nullSentence classification breakdown. null if error.
results[].probabilities.aifloatFraction of sentences confidently classified as AI-generated (0.0–1.0).
results[].probabilities.humanfloatFraction of sentences confidently classified as human-written (0.0–1.0).
results[].probabilities.ai_lowfloatFraction of sentences with low-confidence AI classification (0.0–1.0).
results[].probabilities.human_lowfloatFraction of sentences with low-confidence human classification (0.0–1.0).
results[].segmentsfloat[]Per-sentence AI scores.
results[].report_idstring (uuid)|nullReport identifier, null if error. Download the PDF certificate at GET /api/report/download/{report_id}.
results[].errorobject|nullnull on success, or {code, message} for validation errors.
results[].error.codestringError code, e.g. validation:low_words.
results[].error.messagestringHuman-readable error description.
\n
\n

Error response

\n

All errors follow the same format:

\n
{\"status\": \"error\", \"error\": {\"code\": \"<type>:<code>\", \"message\": \"...\"}}\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
HTTP statusCodeWhen
403permission_denied:api_key_does_not_existThe API key is not recognised.
403not_authenticated:not_authenticatedNo API key was supplied.
403permission_denied:api_key_plan_incompatibleYour plan does not include API access.
403rich_limit:words_limit_reachedWord quota exhausted.
400validation:batch_limitNumber of texts exceeds the batch size limit for your plan.
400validation:no_text_providedtexts is missing, or is not a list of strings.
400validation:rate_limitRequests-per-second limit for your plan exceeded.
500server:serverInternal processing error.
500server:service_unavailableTimeout or service temporarily unavailable.
\n
","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"638494df-edea-478f-8c6a-a481fb0ad6ec","id":"638494df-edea-478f-8c6a-a481fb0ad6ec","name":"It's AI API","type":"collection"}},"urlObject":{"path":["api","v2","batch"],"host":["https://api.its-ai.org"],"query":[],"variable":[]}},"response":[{"id":"54b7015b-0ce9-4cf6-baba-d9f09d37c654","name":"200 OK","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"texts\": [\n \"string\",\n \"string\"\n ],\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/batch"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"results\": [\n {\n \"score\": 0.86,\n \"ai_percentage\": 0.21,\n \"probabilities\": {\n \"ai\": 0.42,\n \"ai_low\": 0.22,\n \"human\": 0.27,\n \"human_low\": 0.45\n },\n \"segments\": [\n 0.12,\n 0.58,\n 0.33,\n 0.74,\n 0.91,\n 0.26,\n 0.49,\n 0.65,\n 0.18,\n 0.82,\n 0.37,\n 0.69,\n 0.24,\n 0.88,\n 0.41,\n 0.57,\n 0.13,\n 0.52,\n 0.79,\n 0.31\n ],\n \"report_id\": \"00000000-0000-0000-0000-000000000000\",\n \"error\": null\n },\n {\n \"score\": null,\n \"ai_percentage\": null,\n \"probabilities\": null,\n \"segments\": [],\n \"report_id\": null,\n \"error\": {\n \"code\": \"validation:low_words\",\n \"message\": \"Try typing more text (>200 characters) so we can give you more accurate results\"\n }\n }\n ]\n}"},{"id":"9699cca6-2926-4ab1-b689-add64e409b42","name":"400 Bad Request","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"texts\": [\n \"string\",\n \"string\"\n ],\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/batch"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"validation:low_words\",\n \"message\": \"Try typing more text (>200 characters) so we can give you more accurate results\"\n }\n}"},{"id":"7122e185-502a-4e69-969c-2993e283017e","name":"403 Forbidden — unknown API key","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"texts\": [\n \"string\",\n \"string\"\n ],\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/batch"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"permission_denied:api_key_does_not_exist\",\n \"message\": \"Invalid API key provided\"\n }\n}"},{"id":"f158c153-ae0c-4038-a239-3284d8b0676d","name":"403 Forbidden","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"texts\": [\n \"string\",\n \"string\"\n ],\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/batch"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"rich_limit:words_limit_reached\",\n \"message\": \"Word limit reached\"\n }\n}"},{"id":"fc6f3c46-8e3f-4c8e-9232-385edf984863","name":"400 Bad Request — rate limit","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"texts\": [\n \"string\",\n \"string\"\n ],\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/batch"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"validation:rate_limit\",\n \"message\": \"Rate limit exceeded\"\n }\n}"},{"id":"4807e2b9-1607-4a42-b914-1e3a4e65de30","name":"500 Internal Server Error","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"texts\": [\n \"string\",\n \"string\"\n ],\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/batch"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"server:service_unavailable\",\n \"message\": \"Service is temporarily unavailable. Please, try again later\"\n }\n}"}],"_postman_id":"56cd888d-c474-417b-adb0-96025d02fa3c"},{"name":"Check text for plagiarism","id":"e2fc0a95-d0ac-44e3-80d2-65078420fdcc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/plagiarism/text","description":"

Submit a single text for a plagiarism check.

\n

Authenticate via Authorization: APIKey <your_key> header or api_key field in the request body.\nThe request is synchronous — it blocks until the check completes (up to ~5 minutes). A plagiarism check costs twice the words of an AI scan of the same text.

\n
\n

Request fields

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeRequiredDescription
textstringyesThe text to check. Minimum 200 characters, maximum depends on your subscription plan.
api_keystringnoAPI key — alternative to the Authorization header.
\n
\n

Successful response (200)

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
scorefloatShare of the text found in other sources, from 0.0 (original) to 1.0 (fully copied). Same direction as the AI score: higher means worse.
resultsobject[]One entry per matched source.
results[].titlestringTitle of the matched source.
results[].linkstringDomain / URL of the matched source.
results[].idintegerZero-based index of this source within results.
results[].scorefloatShare of the text matched by this particular source (0.0–1.0).
results[].matchesobject[]Matched fragments for this source.
results[].matches[].text_sentencestringFragment of the submitted text that matched.
results[].matches[].match_textstringThe matching fragment in the source.
results[].matches[].match_scorefloatSimilarity between the two fragments (0.0–1.0).
results[].matches[].linkstringExact URL of the matched page.
report_idstring (uuid)Report identifier. Download the PDF certificate at GET /api/report/download/{report_id}.
\n
\n

Error response

\n

All errors follow the same format:

\n
{\"status\": \"error\", \"error\": {\"code\": \"<type>:<code>\", \"message\": \"...\"}}\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
HTTP statusCodeWhen
403permission_denied:api_key_does_not_existThe API key is not recognised.
403not_authenticated:not_authenticatedNo API key was supplied.
403permission_denied:api_key_plan_incompatibleYour plan does not include API access.
403rich_limit:words_limit_reachedWord quota exhausted.
403rich_limit:plagiarism_attemptsFree plagiarism-check limit reached.
403rich_limit:text_exceeds_character_limitText exceeds the maximum length for your plan.
400validation:low_wordsText is shorter than 200 characters.
400validation:only_englishUnsupported language detected.
400validation:no_text_providedtext field is missing.
400validation:rate_limitRequests-per-second limit for your plan exceeded.
500server:service_unavailableThe check did not finish within the timeout.
503server:<code>The plagiarism checker reported a failure.
\n
","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"638494df-edea-478f-8c6a-a481fb0ad6ec","id":"638494df-edea-478f-8c6a-a481fb0ad6ec","name":"It's AI API","type":"collection"}},"urlObject":{"path":["api","v2","plagiarism","text"],"host":["https://api.its-ai.org"],"query":[],"variable":[]}},"response":[{"id":"7f1268dc-ff09-4d68-be29-8aa9fc419416","name":"200 OK","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/plagiarism/text"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"score\": 0.124,\n \"results\": [\n {\n \"title\": \"The history of the printing press\",\n \"link\": \"example.com\",\n \"id\": 0,\n \"matches\": [\n {\n \"text_sentence\": \"The printing press was invented in the fifteenth century.\",\n \"match_text\": \"The printing press was invented in the 15th century.\",\n \"match_score\": 0.93,\n \"link\": \"https://example.com/articles/printing-press\"\n }\n ],\n \"score\": 0.124\n }\n ],\n \"report_id\": \"00000000-0000-0000-0000-000000000000\"\n}"},{"id":"428a6bcf-38dd-4e5f-955d-7ca8d506dfae","name":"400 Bad Request","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/plagiarism/text"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"validation:low_words\",\n \"message\": \"Try typing more text (>200 characters) so we can give you more accurate results\"\n }\n}"},{"id":"fca86707-4e7b-4a84-b281-ca0d2878f79f","name":"403 Forbidden — unknown API key","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/plagiarism/text"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"permission_denied:api_key_does_not_exist\",\n \"message\": \"Invalid API key provided\"\n }\n}"},{"id":"957d57db-fa60-4433-947a-41ae13d46ec3","name":"403 Forbidden","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/plagiarism/text"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"rich_limit:plagiarism_attempts\",\n \"message\": \"You have reached your free plagiarism attempts limit\"\n }\n}"},{"id":"5c2d841f-09cf-49c4-9940-5a8302aacc67","name":"400 Bad Request — rate limit","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/plagiarism/text"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"validation:rate_limit\",\n \"message\": \"Rate limit exceeded\"\n }\n}"},{"id":"6cf54620-725d-4aac-9d50-e56d2f975ce9","name":"500 Internal Server Error","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/plagiarism/text"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"server:service_unavailable\",\n \"message\": \"Service is temporarily unavailable. Please, try again later\"\n }\n}"},{"id":"eefc8e62-71f3-428f-9df2-e82c243c8648","name":"503 Service Unavailable","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/plagiarism/text"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"server:service_unavailable\",\n \"message\": \"Service is temporarily unavailable. Please, try again later\"\n }\n}"}],"_postman_id":"e2fc0a95-d0ac-44e3-80d2-65078420fdcc"},{"name":"Check text grammar","id":"c8d56bef-717d-4bc6-bca8-fd642f0b009c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/grammar/text","description":"

Submit a single text for a grammar and style check.

\n

Authenticate via Authorization: APIKey <your_key> header or api_key field in the request body.\nThe request is synchronous — it blocks until the check completes. A grammar check costs the same number of words as an AI scan of the same text (a plagiarism check costs twice as much).

\n

Unlike AI detection, this endpoint is multilingual and accepts short texts (from 20 characters).

\n
\n

Request fields

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeRequiredDescription
textstringyesThe text to check. Minimum 20 characters, maximum depends on your subscription plan.
api_keystringnoAPI key — alternative to the Authorization header.
\n
\n

Successful response (200)

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
matchesobject[]One entry per detected issue.
matches[].idstringIdentifier of the issue within this response.
matches[].offsetintegerZero-based character offset of the issue in the text.
matches[].lengthintegerLength of the issue in characters.
matches[].contextstringSurrounding text of the issue.
matches[].messagestringFull description of the issue.
matches[].short_messagestringShort description, may be empty.
matches[].replacementsstring[]Suggested corrections, best first.
matches[].severitystringerror, warning or style.
matches[].issue_typestringLanguageTool issue type.
matches[].category / category_idstringIssue category.
matches[].rule_idstringLanguageTool rule that fired.
matches[].urlstring|nullDocumentation link for the rule, when available.
languagestringDetected language code, e.g. en-US.
statsobjectIssue counts by severity: errors, warnings, style, total.
report_idstring (uuid)Report identifier. Note: the PDF certificate at GET /api/report/download/{report_id} covers AI and plagiarism results only, so it returns 404 for a grammar-only scan.
\n
\n

Error response

\n

All errors follow the same format:

\n
{\"status\": \"error\", \"error\": {\"code\": \"<type>:<code>\", \"message\": \"...\"}}\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
HTTP statusCodeWhen
403permission_denied:api_key_does_not_existThe API key is not recognised.
403not_authenticated:not_authenticatedNo API key was supplied.
403permission_denied:api_key_plan_incompatibleYour plan does not include API access.
403rich_limit:words_limit_reachedWord quota exhausted.
403rich_limit:grammar_attemptsFree grammar-check limit reached.
403rich_limit:text_exceeds_character_limitText exceeds the maximum length for your plan.
400validation:low_wordsText is too short.
400validation:no_text_providedtext field is missing.
400validation:rate_limitRequests-per-second limit for your plan exceeded.
500server:service_unavailableThe check did not finish within the timeout.
503server:<code>The check failed, or grammar checking is disabled.
\n
","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"638494df-edea-478f-8c6a-a481fb0ad6ec","id":"638494df-edea-478f-8c6a-a481fb0ad6ec","name":"It's AI API","type":"collection"}},"urlObject":{"path":["api","v2","grammar","text"],"host":["https://api.its-ai.org"],"query":[],"variable":[]}},"response":[{"id":"a977fd8f-7b2c-484f-a271-90ca04921585","name":"200 OK","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/grammar/text"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"matches\": [\n {\n \"id\": \"0\",\n \"offset\": 4,\n \"length\": 2,\n \"context\": \"She go to school every single day, and she is ...\",\n \"rule_id\": \"HE_VERB_AGR\",\n \"category_id\": \"GRAMMAR\",\n \"category\": \"Grammar\",\n \"issue_type\": \"grammar\",\n \"severity\": \"error\",\n \"short_message\": \"Agreement error\",\n \"message\": \"The pronoun ‘She’ is usually used with a third-person or a past tense verb.\",\n \"replacements\": [\n \"goes\",\n \"went\"\n ],\n \"url\": \"https://languagetool.org/insights/post/grammar-subject-verb-agreement/\"\n },\n {\n \"id\": \"1\",\n \"offset\": 46,\n \"length\": 9,\n \"context\": \"... to school every single day, and she is very very happy about it.\",\n \"rule_id\": \"RB_RB_COMMA\",\n \"category_id\": \"PUNCTUATION\",\n \"category\": \"Punctuation\",\n \"issue_type\": \"uncategorized\",\n \"severity\": \"style\",\n \"short_message\": \"\",\n \"message\": \"Consider adding a comma between these intensifiers.\",\n \"replacements\": [\n \"very, very\",\n \"very\"\n ],\n \"url\": null\n },\n {\n \"id\": \"2\",\n \"offset\": 67,\n \"length\": 2,\n \"context\": \"...le day, and she is very very happy about it.\",\n \"rule_id\": \"CONSECUTIVE_SPACES\",\n \"category_id\": \"TYPOGRAPHY\",\n \"category\": \"Typography\",\n \"issue_type\": \"typographical\",\n \"severity\": \"error\",\n \"short_message\": \"\",\n \"message\": \"It seems like there are too many consecutive spaces here.\",\n \"replacements\": [\n \" \"\n ],\n \"url\": null\n }\n ],\n \"language\": \"en-US\",\n \"stats\": {\n \"errors\": 2,\n \"warnings\": 0,\n \"style\": 1,\n \"total\": 3\n },\n \"report_id\": \"00000000-0000-0000-0000-000000000000\"\n}"},{"id":"d34e286c-0a03-4711-b79c-87a8ee75b453","name":"400 Bad Request","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/grammar/text"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"validation:low_words\",\n \"message\": \"Try typing more text (>20 characters) so we can give you more accurate results\"\n }\n}"},{"id":"1ad408b0-3e14-448d-94bd-46d4e5cd356a","name":"403 Forbidden — unknown API key","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/grammar/text"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"permission_denied:api_key_does_not_exist\",\n \"message\": \"Invalid API key provided\"\n }\n}"},{"id":"3ef4dc40-fbe4-4f5d-976a-e82431fe1698","name":"403 Forbidden","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/grammar/text"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"rich_limit:grammar_attempts\",\n \"message\": \"You have reached your free grammar checks limit\"\n }\n}"},{"id":"1712b682-a0b4-4152-9540-9036b5963df6","name":"400 Bad Request — rate limit","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/grammar/text"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"validation:rate_limit\",\n \"message\": \"Rate limit exceeded\"\n }\n}"},{"id":"5927af2e-8b04-4a25-a7f4-ce2d574b8ef7","name":"500 Internal Server Error","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/grammar/text"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"server:service_unavailable\",\n \"message\": \"Service is temporarily unavailable. Please, try again later\"\n }\n}"},{"id":"071fc852-f484-4141-b5d5-07872b38d9af","name":"503 Service Unavailable","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/grammar/text"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"server:service_unavailable\",\n \"message\": \"Service is temporarily unavailable. Please, try again later\"\n }\n}"}],"_postman_id":"c8d56bef-717d-4bc6-bca8-fd642f0b009c"},{"name":"Batch check text grammar","id":"607bf4a3-5f9f-4ee7-90d6-2a2b4963fbdb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"texts\": [\n \"string\",\n \"string\"\n ],\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/grammar/batch","description":"

Submit multiple texts for a grammar and style check in a single request.

\n

Authenticate via Authorization: APIKey <your_key> header or api_key field in the request body.\nThe request is synchronous. Invalid texts return per-item errors instead of failing the entire request. Each text costs the same number of words as an AI scan of it; the whole batch is reserved up front, so an unaffordable batch is rejected before any text is checked.

\n
\n

Request fields

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeRequiredDescription
textsstring[]yesTexts to check. Each must be at least 20 characters and not exceed the maximum length for your plan.
api_keystringnoAPI key — alternative to the Authorization header.
\n

The batch size limit per plan is the same as for AI batch analysis.

\n
\n

Successful response (200)

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
resultsobject[]One result per submitted text, in the same order.
results[].errorobject|nullnull on success, or {code, message} when this text failed. On failure the other fields are empty.
\n

Each successful item carries the same fields as the single-text endpoint:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
matchesobject[]One entry per detected issue.
matches[].idstringIdentifier of the issue within this response.
matches[].offsetintegerZero-based character offset of the issue in the text.
matches[].lengthintegerLength of the issue in characters.
matches[].contextstringSurrounding text of the issue.
matches[].messagestringFull description of the issue.
matches[].short_messagestringShort description, may be empty.
matches[].replacementsstring[]Suggested corrections, best first.
matches[].severitystringerror, warning or style.
matches[].issue_typestringLanguageTool issue type.
matches[].category / category_idstringIssue category.
matches[].rule_idstringLanguageTool rule that fired.
matches[].urlstring|nullDocumentation link for the rule, when available.
languagestringDetected language code, e.g. en-US.
statsobjectIssue counts by severity: errors, warnings, style, total.
report_idstring (uuid)|nullReport identifier for this text.
\n
\n

Error response

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
HTTP statusCodeWhen
403permission_denied:api_key_does_not_existThe API key is not recognised.
403not_authenticated:not_authenticatedNo API key was supplied.
403permission_denied:api_key_plan_incompatibleYour plan does not include API access.
403rich_limit:words_limit_reachedWord quota exhausted by the batch as a whole.
400validation:batch_limitNumber of texts exceeds the batch size limit for your plan.
400validation:no_text_providedtexts is missing, or is not a list of strings.
400validation:rate_limitRequests-per-second limit for your plan exceeded.
500server:service_unavailableUnexpected server error. A text that fails or times out on its own comes back in results[].error instead.
503server:service_unavailableGrammar checking is disabled.
\n

Per-item codes, returned inside results[].error rather than as an HTTP error:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
CodeWhen
validation:low_wordsThis text is shorter than 20 characters.
rich_limit:text_exceeds_max_lengthThis text exceeds the maximum length for your plan. Carries text_index (1-based), text_length and max_length.
server:<code>The check failed for this text.
\n
","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"638494df-edea-478f-8c6a-a481fb0ad6ec","id":"638494df-edea-478f-8c6a-a481fb0ad6ec","name":"It's AI API","type":"collection"}},"urlObject":{"path":["api","v2","grammar","batch"],"host":["https://api.its-ai.org"],"query":[],"variable":[]}},"response":[{"id":"cb83d8a9-d14f-49d1-a0b8-c49e3fcf3ac5","name":"200 OK","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"texts\": [\n \"string\",\n \"string\"\n ],\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/grammar/batch"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"results\": [\n {\n \"matches\": [\n {\n \"id\": \"0\",\n \"offset\": 4,\n \"length\": 2,\n \"context\": \"She go to school every single day, and she is ...\",\n \"rule_id\": \"HE_VERB_AGR\",\n \"category_id\": \"GRAMMAR\",\n \"category\": \"Grammar\",\n \"issue_type\": \"grammar\",\n \"severity\": \"error\",\n \"short_message\": \"Agreement error\",\n \"message\": \"The pronoun ‘She’ is usually used with a third-person or a past tense verb.\",\n \"replacements\": [\n \"goes\",\n \"went\"\n ],\n \"url\": \"https://languagetool.org/insights/post/grammar-subject-verb-agreement/\"\n },\n {\n \"id\": \"1\",\n \"offset\": 46,\n \"length\": 9,\n \"context\": \"... to school every single day, and she is very very happy about it.\",\n \"rule_id\": \"RB_RB_COMMA\",\n \"category_id\": \"PUNCTUATION\",\n \"category\": \"Punctuation\",\n \"issue_type\": \"uncategorized\",\n \"severity\": \"style\",\n \"short_message\": \"\",\n \"message\": \"Consider adding a comma between these intensifiers.\",\n \"replacements\": [\n \"very, very\",\n \"very\"\n ],\n \"url\": null\n },\n {\n \"id\": \"2\",\n \"offset\": 67,\n \"length\": 2,\n \"context\": \"...le day, and she is very very happy about it.\",\n \"rule_id\": \"CONSECUTIVE_SPACES\",\n \"category_id\": \"TYPOGRAPHY\",\n \"category\": \"Typography\",\n \"issue_type\": \"typographical\",\n \"severity\": \"error\",\n \"short_message\": \"\",\n \"message\": \"It seems like there are too many consecutive spaces here.\",\n \"replacements\": [\n \" \"\n ],\n \"url\": null\n }\n ],\n \"language\": \"en-US\",\n \"stats\": {\n \"errors\": 2,\n \"warnings\": 0,\n \"style\": 1,\n \"total\": 3\n },\n \"report_id\": \"00000000-0000-0000-0000-000000000000\",\n \"error\": null\n },\n {\n \"matches\": [],\n \"language\": \"\",\n \"stats\": {\n \"errors\": 0,\n \"warnings\": 0,\n \"style\": 0,\n \"total\": 0\n },\n \"report_id\": null,\n \"error\": {\n \"code\": \"validation:low_words\",\n \"message\": \"Try typing more text (>20 characters) so we can give you more accurate results\"\n }\n }\n ]\n}"},{"id":"58e1a27c-29ca-4f39-9cb5-fa20b2bac170","name":"400 Bad Request","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"texts\": [\n \"string\",\n \"string\"\n ],\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/grammar/batch"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"validation:batch_limit\",\n \"message\": \"Maximum batch size exceeded\"\n }\n}"},{"id":"373cf44d-5fe2-488a-aeb9-3d7db902f5dc","name":"403 Forbidden — unknown API key","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"texts\": [\n \"string\",\n \"string\"\n ],\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/grammar/batch"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"permission_denied:api_key_does_not_exist\",\n \"message\": \"Invalid API key provided\"\n }\n}"},{"id":"2a661388-0e36-4c50-a196-99b290bc1900","name":"403 Forbidden","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"texts\": [\n \"string\",\n \"string\"\n ],\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/grammar/batch"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"rich_limit:words_limit_reached\",\n \"message\": \"Word limit reached\"\n }\n}"},{"id":"cdd38141-d7f5-425f-bb44-1e987c07fba0","name":"400 Bad Request — rate limit","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"texts\": [\n \"string\",\n \"string\"\n ],\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/grammar/batch"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"validation:rate_limit\",\n \"message\": \"Rate limit exceeded\"\n }\n}"},{"id":"fc88591d-b391-4e54-a2ce-f90390dda686","name":"500 Internal Server Error","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"texts\": [\n \"string\",\n \"string\"\n ],\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/grammar/batch"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"server:service_unavailable\",\n \"message\": \"Service is temporarily unavailable. Please, try again later\"\n }\n}"},{"id":"94c7ee0e-8301-4aba-a33e-57ad0c583ceb","name":"503 Service Unavailable","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"texts\": [\n \"string\",\n \"string\"\n ],\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/v2/grammar/batch"},"status":"Service Unavailable","code":503,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"server:service_unavailable\",\n \"message\": \"Service is temporarily unavailable. Please, try again later\"\n }\n}"}],"_postman_id":"607bf4a3-5f9f-4ee7-90d6-2a2b4963fbdb"},{"name":"Download scan certificate (PDF)","id":"462f97de-a3e3-4252-a964-9020c630da3b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/pdf"}],"url":"https://api.its-ai.org/api/report/download/00000000-0000-0000-0000-000000000000","description":"

Download the certificate for a scan as a PDF attachment (binary body, Content-Type: application/pdf).

\n

Use the report_id returned by the analysis endpoints (/api/text, /api/v2/text, /api/batch, /api/v2/batch, /api/v2/plagiarism/text) as the path parameter.

\n

The scan must have at least one completed AI or plagiarism result, otherwise 404 is returned. The certificate renders AI detection and plagiarism only, so the report_id of a grammar check always answers 404 not_found:analysis_not_completed — grammar results are returned in the response body instead.

\n

Authenticate with the same API key that ran the scan. Through the API a certificate is served only to the account the scan belongs to — the report_id alone is not enough. Sharing one still works: the report page its QR code links to hands the same PDF to whoever opens it.

\n
\n

Path & query parameters

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ParameterInRequiredDescription
report_idpathyesThe report_id (report UUID) from a scan response.
tzquerynoIANA timezone for dates rendered in the PDF, e.g. Europe/Moscow. Defaults to UTC.
langquerynoLocale for the certificate copy, e.g. fr. Unknown values fall back to English.
\n
\n

Response

\n
    \n
  • 200 — the PDF file as an attachment (Content-Type: application/pdf, Content-Disposition: attachment; filename=...).
    • \n
  • 403 — permission_denied:report_not_owned (the scan belongs to another account, or no key was supplied).
    • \n
  • 404 — not_found:analysis_not_found (unknown or malformed report_id) or not_found:analysis_not_completed (no finished AI or plagiarism result).
    • \n
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"638494df-edea-478f-8c6a-a481fb0ad6ec","id":"638494df-edea-478f-8c6a-a481fb0ad6ec","name":"It's AI API","type":"collection"}},"urlObject":{"path":["api","report","download","00000000-0000-0000-0000-000000000000"],"host":["https://api.its-ai.org"],"query":[{"disabled":true,"description":{"content":"

Optional IANA timezone for dates in the PDF. Defaults to UTC.

\n","type":"text/plain"},"key":"tz","value":"Europe/Moscow"}],"variable":[]}},"response":[{"id":"9ea38340-4634-4e06-b8ba-2bb8d0032c69","name":"200 OK (PDF attachment)","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/pdf"}],"url":{"raw":"https://api.its-ai.org/api/report/download/00000000-0000-0000-0000-000000000000","host":["https://api.its-ai.org"],"path":["api","report","download","00000000-0000-0000-0000-000000000000"],"query":[{"key":"tz","value":"Europe/Moscow","description":"Optional IANA timezone for dates in the PDF. Defaults to UTC.","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"application/pdf"},{"key":"Content-Disposition","value":"attachment; filename=\"scan-report Sample scan text.pdf\""}],"cookie":[],"responseTime":null,"body":""},{"id":"4e1cf9b7-c144-45a4-9efe-684c5bb734c2","name":"403 Forbidden — not your scan","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/pdf"}],"url":{"raw":"https://api.its-ai.org/api/report/download/00000000-0000-0000-0000-000000000000","host":["https://api.its-ai.org"],"path":["api","report","download","00000000-0000-0000-0000-000000000000"],"query":[{"key":"tz","value":"Europe/Moscow","description":"Optional IANA timezone for dates in the PDF. Defaults to UTC.","disabled":true}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"permission_denied:report_not_owned\",\n \"message\": \"This certificate belongs to the account that ran the scan\"\n }\n}"},{"id":"e6551e73-d94e-4fd9-8e3b-c26522cf5726","name":"404 Not Found","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/pdf"}],"url":{"raw":"https://api.its-ai.org/api/report/download/00000000-0000-0000-0000-000000000000","host":["https://api.its-ai.org"],"path":["api","report","download","00000000-0000-0000-0000-000000000000"],"query":[{"key":"tz","value":"Europe/Moscow","description":"Optional IANA timezone for dates in the PDF. Defaults to UTC.","disabled":true}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"not_found:analysis_not_found\",\n \"message\": \"Analysis not found\"\n }\n}"}],"_postman_id":"462f97de-a3e3-4252-a964-9020c630da3b"}],"id":"061d0aff-f94a-4580-a126-e280e0322917","_postman_id":"061d0aff-f94a-4580-a126-e280e0322917","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"638494df-edea-478f-8c6a-a481fb0ad6ec","id":"638494df-edea-478f-8c6a-a481fb0ad6ec","name":"It's AI API","type":"collection"}}},{"name":"v1","item":[{"name":"Analyze text","id":"6c11ec3f-7938-4a40-b844-944811a713ef","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"deep_scan\": false,\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/text","description":"

Submit a single text for AI detection analysis.

\n

Authenticate via Authorization: APIKey <your_key> header or api_key field in the request body.\nThe request is synchronous — it blocks until the analysis completes (up to 5 minutes).

\n
\n

Request fields

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeRequiredDescription
textstringyesThe text to analyze. Minimum 200 characters, maximum depends on your subscription plan.
deep_scanbooleannoWhen true, the response includes per-sentence AI scores in segmentation_tokens (default: false). Deep scan uses more quota.
api_keystringnoAPI key — alternative to the Authorization header.
\n
\n

Successful response (200)

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
answerfloatOverall AI detection score from 0.0 (human) to 1.0 (AI).
statusstring\"success\" when the analysis completed normally.
segmentation_tokensfloat[]Per-sentence AI scores. Populated only when deep_scan=true, otherwise empty array [].
report_idstring (uuid)Report identifier. Download the PDF certificate at GET /api/report/download/{report_id}.
\n
\n

Error response

\n

All errors follow the same format:

\n
{\"status\": \"error\", \"error\": {\"code\": \"<type>:<code>\", \"message\": \"...\"}}\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
HTTP statusCodeWhen
403permission_denied:api_key_does_not_existThe API key is not recognised.
403not_authenticated:not_authenticatedNo API key was supplied.
403permission_denied:api_key_plan_incompatibleYour plan does not include API access.
403rich_limit:words_limit_reachedWord quota exhausted.
403rich_limit:text_exceeds_character_limitText exceeds the maximum length for your plan.
400validation:low_wordsText is shorter than 200 characters.
400validation:only_englishUnsupported language detected.
400validation:no_text_providedtext field is missing.
400validation:rate_limitRequests-per-second limit for your plan exceeded.
500server:service_unavailableInternal processing error or timeout.
\n
","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"638494df-edea-478f-8c6a-a481fb0ad6ec","id":"638494df-edea-478f-8c6a-a481fb0ad6ec","name":"It's AI API","type":"collection"}},"urlObject":{"path":["api","text"],"host":["https://api.its-ai.org"],"query":[],"variable":[]}},"response":[{"id":"9c99088a-09df-47cf-b8dc-7248ff05f4a1","name":"200 OK","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"deep_scan\": false,\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/text"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"answer\": 0.27,\n \"status\": \"success\",\n \"segmentation_tokens\": [\n 0.6,\n 0.4,\n 0.73,\n 0.28,\n 0.91,\n 0.35,\n 0.66,\n 0.18,\n 0.84,\n 0.49,\n 0.57,\n 0.22,\n 0.78,\n 0.31,\n 0.69,\n 0.14,\n 0.95,\n 0.43,\n 0.52,\n 0.87\n ],\n \"report_id\": \"00000000-0000-0000-0000-000000000000\"\n}"},{"id":"829dffb4-3f04-4126-8434-29787e5b9a72","name":"400 Bad Request","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"deep_scan\": false,\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/text"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"validation:low_words\",\n \"message\": \"Try typing more text (>200 characters) so we can give you more accurate results\"\n }\n}"},{"id":"81d9a899-834b-4965-8929-ece23954fc87","name":"403 Forbidden — unknown API key","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"deep_scan\": false,\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/text"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"permission_denied:api_key_does_not_exist\",\n \"message\": \"Invalid API key provided\"\n }\n}"},{"id":"0b331655-2522-4812-87cb-f5868bf1c2f6","name":"403 Forbidden","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"deep_scan\": false,\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/text"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"rich_limit:words_limit_reached\",\n \"message\": \"Word limit reached\"\n }\n}"},{"id":"a85379ec-9937-4577-89de-d06537f251fa","name":"400 Bad Request — rate limit","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"deep_scan\": false,\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/text"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"validation:rate_limit\",\n \"message\": \"Rate limit exceeded\"\n }\n}"},{"id":"48c87bdb-bdd3-4619-bf81-2e75398e6c72","name":"500 Internal Server Error","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"string\",\n \"deep_scan\": false,\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/text"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"server:service_unavailable\",\n \"message\": \"Service is temporarily unavailable. Please, try again later\"\n }\n}"}],"_postman_id":"6c11ec3f-7938-4a40-b844-944811a713ef"},{"name":"Batch analyze texts","id":"e19844c1-7550-4869-9f27-78b946456648","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"texts\": [\n \"string\",\n \"string\"\n ],\n \"deep_scan\": false,\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/batch","description":"

Submit multiple texts for AI detection analysis in a single request.

\n

Authenticate via Authorization: APIKey <your_key> header or api_key field in the request body.\nThe request is synchronous — it blocks until all analyses complete (up to 5 minutes).

\n
\n

Request fields

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeRequiredDescription
textsstring[]yesList of texts to analyze. Each text must be at least 200 characters and not exceed the maximum length for your plan.
deep_scanbooleannoWhen true, each result includes per-sentence AI scores in segmentation_tokens (default: false). Deep scan uses more quota.
api_keystringnoAPI key — alternative to the Authorization header.
\n

Batch size limit: 250 texts per request. That is the Enterprise allowance, and API keys are an Enterprise feature — the smaller per-plan batch limits (Pay as you go 1, Free 3, Plus 10, Premium 25, Pro 50) apply inside the web app, and are only reachable through the API by a key whose plan was downgraded, which the plan gate rejects first.

\n
\n

Successful response (200)

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
answerobject[]Array of results, one per submitted text, in the same order.
answer[].textstringThe original submitted text.
answer[].answerfloatOverall AI detection score from 0.0 (human) to 1.0 (AI).
answer[].segmentation_tokensfloat[]Per-sentence AI scores. Populated only when deep_scan=true, otherwise empty array [].
answer[].report_idstring (uuid)Report identifier. Download the PDF certificate at GET /api/report/download/{report_id}.
errorstring|nullnull on success.
\n
\n

Error response

\n

All errors follow the same format:

\n
{\"status\": \"error\", \"error\": {\"code\": \"<type>:<code>\", \"message\": \"...\"}}\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
HTTP statusCodeWhen
403permission_denied:api_key_does_not_existThe API key is not recognised.
403not_authenticated:not_authenticatedNo API key was supplied.
403permission_denied:api_key_plan_incompatibleYour plan does not include API access.
403rich_limit:words_limit_reachedWord quota exhausted.
403rich_limit:text_exceeds_max_lengthA text exceeds the maximum length for your plan.
400validation:low_wordsA text is shorter than 200 characters.
400validation:batch_limitNumber of texts exceeds the batch size limit for your plan.
400validation:no_text_providedtexts is missing, or is not a list of strings.
400validation:rate_limitRequests-per-second limit for your plan exceeded.
500server:serverInternal processing error.
500server:service_unavailableTimeout or service temporarily unavailable.
\n
","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"638494df-edea-478f-8c6a-a481fb0ad6ec","id":"638494df-edea-478f-8c6a-a481fb0ad6ec","name":"It's AI API","type":"collection"}},"urlObject":{"path":["api","batch"],"host":["https://api.its-ai.org"],"query":[],"variable":[]}},"response":[{"id":"960f213a-c06c-4d75-b911-23408fe4737a","name":"200 OK","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"texts\": [\n \"string\",\n \"string\"\n ],\n \"deep_scan\": false,\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/batch"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"answer\": [\n {\n \"text\": \"string\",\n \"answer\": 0.27,\n \"segmentation_tokens\": [\n 0.6,\n 0.4,\n 0.73,\n 0.28,\n 0.91,\n 0.35,\n 0.66,\n 0.18,\n 0.84,\n 0.49,\n 0.57,\n 0.22,\n 0.78,\n 0.31,\n 0.69,\n 0.14,\n 0.95,\n 0.43,\n 0.52,\n 0.87\n ],\n \"report_id\": \"00000000-0000-0000-0000-000000000000\"\n },\n {\n \"text\": \"string\",\n \"answer\": 0.64,\n \"segmentation_tokens\": [\n 0.12,\n 0.58,\n 0.33,\n 0.74,\n 0.91,\n 0.26,\n 0.49,\n 0.65,\n 0.18,\n 0.82,\n 0.37,\n 0.69,\n 0.24,\n 0.88,\n 0.41,\n 0.57,\n 0.13,\n 0.52,\n 0.79,\n 0.31\n ],\n \"report_id\": \"00000000-0000-0000-0000-000000000001\"\n }\n ],\n \"error\": null\n}"},{"id":"2cf0f592-fb01-4a7f-881f-5abf25121402","name":"400 Bad Request","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"texts\": [\n \"string\",\n \"string\"\n ],\n \"deep_scan\": false,\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/batch"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"validation:low_words\",\n \"message\": \"Try typing more text (>200 characters) so we can give you more accurate results\"\n }\n}"},{"id":"5b3dcedb-738d-4cc0-8a96-cfb4a2759f27","name":"403 Forbidden — unknown API key","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"texts\": [\n \"string\",\n \"string\"\n ],\n \"deep_scan\": false,\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/batch"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"permission_denied:api_key_does_not_exist\",\n \"message\": \"Invalid API key provided\"\n }\n}"},{"id":"a6264e1e-d2dc-4f50-9c7c-04c49a460c50","name":"403 Forbidden","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"texts\": [\n \"string\",\n \"string\"\n ],\n \"deep_scan\": false,\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/batch"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"rich_limit:words_limit_reached\",\n \"message\": \"Word limit reached\"\n }\n}"},{"id":"40047107-1795-48e6-8c95-ce0f01c41179","name":"400 Bad Request — rate limit","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"texts\": [\n \"string\",\n \"string\"\n ],\n \"deep_scan\": false,\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/batch"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"validation:rate_limit\",\n \"message\": \"Rate limit exceeded\"\n }\n}"},{"id":"8813517b-97f9-44ef-b172-2594523fdfb5","name":"500 Internal Server Error","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"texts\": [\n \"string\",\n \"string\"\n ],\n \"deep_scan\": false,\n \"api_key\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api.its-ai.org/api/batch"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"error\": {\n \"code\": \"server:service_unavailable\",\n \"message\": \"Service is temporarily unavailable. Please, try again later\"\n }\n}"}],"_postman_id":"e19844c1-7550-4869-9f27-78b946456648"}],"id":"4a9dc0f3-10fb-49cf-920f-428b89860c2b","_postman_id":"4a9dc0f3-10fb-49cf-920f-428b89860c2b","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"638494df-edea-478f-8c6a-a481fb0ad6ec","id":"638494df-edea-478f-8c6a-a481fb0ad6ec","name":"It's AI API","type":"collection"}}}],"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]}},"variable":[{"key":"baseUrl","value":"https://api.its-ai.org"},{"key":"apiKey","value":""}]}