---
title: "Analyze up to 50 items in a single request"
method: POST
path: "/api/v1/batch/analyze"
tags: ["Batch"]
---

# Analyze up to 50 items in a single request

`POST /api/v1/batch/analyze`

## Request

- Base URL: `https://api.tuteliq.ai`
- URL: `https://api.tuteliq.ai/api/v1/batch/analyze`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Submit multiple analysis tasks in one API call with optional parallel processing. Each item specifies its type (bullying, grooming, unsafe, or emotions) and data. Returns individual results for each item plus a summary with total/successful/failed counts and processing time. Ideal for content moderation backlogs, message queue processing, and bulk imports.

## Request body

- object
  - `items` object[], required
    - `id` string, required: Unique identifier for this item
    - `type` 'bullying' | 'grooming' | 'unsafe' | 'emotions' | 'social_engineering' | 'app_fraud' | 'romance_scam' | 'mule_recruitment' | 'gambling_harm' | 'coercive_control' | 'vulnerability_exploitation' | 'radicalisation', required: Type of analysis to perform
    - `data` object, required: Data to analyze (varies by type)
  - `parallel` boolean: Process items in parallel (faster but uses more resources)

## Response `200`

Default Response

- object
  - `results` object[]
    - `id` string
    - `type` string
    - `success` boolean
    - `result` object
    - `error` string
    - `error_code` string: Error code for a failed item (e.g. ANALYSIS_6009 for a declared language that is not supported).
    - `credits_used` number
  - `summary` object
    - `total` number
    - `successful` number
    - `failed` number
    - `processingTimeMs` number
    - `total_credits_used` number

## Changes

- **2026-10-19** `8490332e0031`: 1 info
  - added the optional property `results/items/error_code` to the response with the `200` status

[Operation history](https://skmtc.dev/tuteliq/apis/tuteliq-api/changes/api/v1/batch/analyze/post.md)

---

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