---
title: "Analyze a Voice Campaign"
method: POST
path: "/voice/analysis"
---

# Analyze a Voice Campaign

`POST /voice/analysis`

Analyzing a voice campaign sendout is useful when the user needs information about the send out before actually sending it.

## Headers

- `Content-Type` string, required
- `Authorization` string, required

## Request body

- object
  - `from` string, required — The sender id for this call
  - `groups` string[] — The groups of contacts selected as recipients of this call. One of "groups", "to", "contacts" parameters is required.
  - `contacts` string[] — The contacts selected as recipients of this call. One of "groups", "to", "contacts" parameters is required.
  - `to` string[] — The recipients of this call, must be a list with valid numbers (mobiles or landlines). One of "groups", "to", "contacts" parameters is required.
  - `fileURL` string — The url of the wav file to play
  - `message` object — Represents the text message to be converted to wav file
    - `gender` string — The gender of the voice message to be played
    - `language` string — The language of the voice message to be played
    - `text` string — The text of the voice message to be played

## Response `200`

200

- object
  - `numberOfRecipients` integer
  - `recipientsPerCountry` object
    - `GR` integer
    - `GB` integer
  - `recipientCountries` object
    - `+447123123456` string
    - `+306977663127` string
  - `contacts` object
  - `recipientsPerGroup` object
  - `totalInGroups` integer

## Other responses

- `400` — 400

---

[API](https://skmtc.net/routee/apis/auth.md) · [All operations](https://skmtc.net/routee/apis/auth/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/routee/auth/versions/5cef04e8f7d8/schema)