{ "openapi": "3.0.3", "info": { "title": "IllyVoIP Sandbox API", "version": "1.0.0", "description": "IllyVoIP API reference for Sandbox. Use your Sandbox API key with the documented endpoints, request fields and response formats." }, "servers": [ { "url": "https://sandbox-api.illyvoip.com", "description": "Sandbox" } ], "externalDocs": { "description": "Sandbox and environments", "url": "https://illyvoip.com/docs/sandbox/" }, "security": [ { "apiKeyAuth": [] } ], "tags": [ { "name": "lookup", "description": "Phone number normalization plus live operator intelligence and HLR results." }, { "name": "pricing", "description": "Country coverage, prefix search, and quick quotes." }, { "name": "sip", "description": "SIP identities and bootstrap configuration." }, { "name": "sms", "description": "Outbound messaging and delivery status." }, { "name": "contacts", "description": "Contacts, companies, sharing, and workspace metadata." }, { "name": "speech", "description": "Standalone speech-to-text and text-to-speech services." }, { "name": "calls", "description": "Historical call data and call recording access." }, { "name": "dids", "description": "DID catalog, ordering, configuration, and documents." }, { "name": "voice", "description": "Outbound calls, live control, speech, and transfer flows." } ], "paths": { "/api/v1/sms/messages": { "post": { "tags": [ "sms" ], "summary": "Send SMS", "description": "The same endpoint supports single-recipient and bulk-recipient flows. If at least one unique recipient is accepted for delivery, the request succeeds and queues only the accepted recipients. `queued_message_ids` follows those accepted recipients in request order after normalization, duplicate removal, and destination validation. `invalid_numbers` is a separate list of rejected numbers and reasons; it is not positionally paired with `queued_message_ids`. `duplicates_removed` lists normalized duplicates that were not queued. `total_cost` includes only queued recipients. Recipient formatting (spaces, dots, brackets and hyphens) is normalized; 00 is treated as +. The normalized destination must contain 7–15 digits with a recognised international calling code. Country-specific numbering lengths and ranges are advisory for outbound SMS, not proof of reachability. Unrecognised ranges can proceed only when existing routing, pricing and account checks allow them. Digits are never silently added or removed. A provider may still reject the destination. An invalid recipient includes error_code invalid_destination. If every number is invalid, HTTP 400 returns error_code invalid_destination with an explanation; validation precedes carrier lookup, queueing and charging. If numbers are correctly formatted but SMS service is unavailable for all of them, it returns HTTP 400 with the error No valid destinations provided. In either all-rejected case, no message is queued or charged. Encoding is checked before queuing. If Unicode (UCS-2) is unsupported for a destination, its invalid_numbers entry includes error_code unsupported_encoding and a safe explanation. An all-rejected request involving this error returns HTTP 400 with error_code unsupported_encoding. No message is queued or charged and no delivery webhook is generated for validation rejections. The JSON fields are `from`, `to` (an array), and `message`. An optional Idempotency-Key makes retries safe.\n\n## Before you start\n\nProvide a sender ID, a recipient array and message text.\n\n## Response\n\nSave queued_message_ids. Acceptance means queued, not delivered; inspect invalid_numbers separately for rejected recipients.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`, `insufficient-credit`, `idempotency-conflict`.", "operationId": "smsSend", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/sms/send-sms/" }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128, "pattern": "^[A-Za-z0-9:._-]{8,128}$" } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable", "insufficient-credit", "idempotency-conflict" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "from": { "type": "string", "minLength": 1, "maxLength": 11 }, "to": { "type": "array", "minItems": 1, "items": { "type": "string" } }, "message": { "type": "string", "minLength": 1 } }, "required": [ "from", "to", "message" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "queued_message_ids": { "type": "array", "items": { "type": "string" } }, "total_cost": { "type": "number" }, "invalid_numbers": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "number", "reason" ], "properties": { "number": { "type": "string" }, "reason": { "type": "string" }, "error_code": { "type": "string", "enum": [ "unsupported_encoding", "invalid_destination" ] } } } }, "duplicates_removed": { "type": "array", "items": { "type": "string" } }, "encoding": { "type": "string" }, "segments_per_recipient": { "type": "integer" }, "replayed": { "type": "boolean" }, "queued_count": { "type": "integer" }, "text_conversion": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "to": { "type": "string" }, "conversion_possible": { "type": "boolean" }, "conversion_required": { "type": "boolean" }, "converted_message": { "type": "string", "nullable": true }, "encoding_options": { "type": "array", "items": { "type": "string", "enum": [ "GSM-7", "UCS-2" ] } }, "min_segments": { "type": "integer", "minimum": 1 }, "max_segments": { "type": "integer", "minimum": 1 } } } } }, "required": [ "status", "queued_message_ids", "total_cost", "invalid_numbers", "duplicates_removed", "encoding", "segments_per_recipient", "replayed", "queued_count" ] }, "example": { "status": "success", "queued_message_ids": [ "SM-DEMO-FF13D98D36E34448" ], "total_cost": 0.02, "invalid_numbers": [], "duplicates_removed": [], "encoding": "GSM-7", "segments_per_recipient": 1, "replayed": false, "queued_count": 1 } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string" }, "fields": { "type": "object", "additionalProperties": false, "properties": { "review_reference": { "type": "string", "pattern": "^[a-f0-9]{32}$" } } } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "402": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "413": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } } } }, "/api/v1/sms/messages/status": { "get": { "tags": [ "sms" ], "summary": "Get SMS status", "description": "Use this when you poll for message status instead of subscribing to webhooks. Public SMS statuses are queued, sent, delivered, failed, refund_pending, refunded, and unknown.\n\n## Before you start\n\nUse the message ID returned when your SMS was accepted.\n\n## Response\n\nRead the current delivery state and any failure, refund or text-conversion information.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`, `delivered`, `failed`, `queued`.", "operationId": "smsStatus", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/sms/get-sms-status/" }, "parameters": [ { "name": "message_id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable", "delivered", "failed", "queued" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "message_id": { "type": "string" }, "from": { "type": "string" }, "to": { "type": "string" }, "sms_status": { "type": "string", "enum": [ "queued", "sent", "delivered", "failed", "refund_pending", "refunded", "unknown" ] }, "status_label": { "type": "string" }, "status_message": { "type": "string" }, "cost": { "type": "number" }, "created_date": { "type": "string" }, "sent_at": { "type": "string" }, "delivered_at": { "type": "string" }, "updated_at": { "type": "string" }, "refunded": { "type": "boolean" }, "refunded_amount": { "type": "number" }, "refunded_at": { "type": "string" }, "text_conversion_possible": { "type": "boolean" }, "text_conversion_applied": { "type": "boolean" }, "submitted_message": { "type": "string", "nullable": true }, "submitted_encoding": { "type": "string", "nullable": true, "enum": [ "GSM-7", "UCS-2", null ] }, "submitted_segments": { "type": "integer", "nullable": true, "minimum": 1 }, "submission_status": { "type": "string", "enum": [ "queued", "accepted", "unknown", "not_submitted" ] }, "delivery_status": { "type": "string", "enum": [ "pending", "delivered", "partial", "not_delivered", "unknown" ] }, "charge_status": { "type": "string", "enum": [ "reserved", "under_review", "refund_pending", "free", "charged", "refunded", "partially_refunded" ] }, "customer_charge_amount": { "type": "string", "nullable": true }, "refund_amount": { "type": "string" }, "financial_review_required": { "type": "boolean" }, "error_code": { "type": "string", "enum": [ "unsupported_encoding", "invalid_destination" ] }, "error_message": { "type": "string" } }, "required": [ "status", "message_id", "from", "to", "sms_status", "status_label", "status_message", "cost", "created_date", "sent_at", "delivered_at", "updated_at", "refunded", "refunded_amount", "refunded_at" ] }, "example": { "status": "success", "message_id": "SM-DEMO-1111111111111111", "from": "IllyVoIP", "to": "+442079460001", "sms_status": "delivered", "status_label": "Delivered", "status_message": "Demo delivered result.", "cost": 0.05, "created_date": "2026-07-27 10:14:54", "sent_at": "2026-01-15 12:00:00+00:00", "delivered_at": "2026-01-15 12:00:00+00:00", "updated_at": "2026-01-15 12:00:00+00:00", "refunded": false, "refunded_amount": 0, "refunded_at": "" } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } } } }, "/api/v1/stt/languages": { "get": { "tags": [ "speech" ], "summary": "List STT languages", "description": "Use this first when you want to send an explicit `language` hint to speech transcription. Use `context=speech_api` for the dedicated STT API or `context=voice_api` for Voice API recognition hints.\n\n## Before you start\n\nChoose the context for standalone transcription or Voice API recognition.\n\n## Response\n\nUse a canonical language code as an optional recognition hint.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "speechSttLanguages", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/speech/list-stt-languages/" }, "parameters": [ { "name": "context", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "context": { "type": "string" }, "default_language": { "type": "string" }, "languages": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "language": { "type": "string" }, "label": { "type": "string" } }, "required": [ "language", "label" ] } } }, "required": [ "status", "context", "default_language", "languages" ] }, "example": { "status": "success", "context": "default", "default_language": "en", "languages": [ { "language": "en", "label": "English" } ] } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } } } }, "/api/v1/stt/transcribe": { "post": { "tags": [ "speech" ], "summary": "Transcribe audio", "description": "Send a supported audio file as a multipart upload with an optional language hint.\n\n## Before you start\n\nUpload a supported MP3 or WAV file and an optional language hint.\n\n## Response\n\nRead the sample transcript and response metadata.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`, `insufficient-credit`, `unavailable`.\n\nSandbox returns a sample transcript. Audio transcription is available in Production.", "operationId": "speechSttTranscribe", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/speech/transcribe-audio/" }, "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "additionalProperties": false, "properties": { "context": { "type": "string" }, "language": { "type": "string" }, "file": { "type": "string", "format": "binary" } }, "required": [ "file" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "context": { "type": "string" }, "text": { "type": "string" }, "language": { "type": "string" }, "duration_ms": { "type": "integer" } }, "required": [ "status", "context", "text", "language", "duration_ms" ] }, "example": { "status": "success", "context": "default", "text": "This is a fixed IllyVoIP sandbox audio sample.", "language": "en", "duration_ms": 3000 } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "402": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "413": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable", "insufficient-credit", "unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/tts/languages": { "get": { "tags": [ "speech" ], "summary": "List TTS languages", "description": "Use this first, then call `List TTS voices` with one `language` to get the voice names for that language. Use `context=speech_api` for the dedicated TTS API or `context=voice_api` when you need the Voice API speak/gather catalog.\n\n## Before you start\n\nChoose the standalone speech or Voice API context.\n\n## Response\n\nUse a returned language when requesting its voice catalog.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "speechTtsLanguages", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/speech/list-tts-languages/" }, "parameters": [ { "name": "context", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "context": { "type": "string" }, "default_language": { "type": "string" }, "languages": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "language": { "type": "string" }, "label": { "type": "string" } }, "required": [ "language", "label" ] } } }, "required": [ "status", "context", "default_language", "languages" ] }, "example": { "status": "success", "context": "default", "default_language": "en", "languages": [ { "language": "en", "label": "English" } ] } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } } } }, "/api/v1/tts/voices": { "get": { "tags": [ "speech" ], "summary": "List TTS voices", "description": "Use this after `List TTS languages`. The returned `voice` names are the ones you should reuse in the same TTS context you requested.\n\n## Before you start\n\nChoose the context and canonical language for your intended use.\n\n## Response\n\nSelect a public voice key from the response.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "speechTtsVoices", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/speech/list-tts-voices/" }, "parameters": [ { "name": "context", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "language", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "context": { "type": "string" }, "language": { "type": "string" }, "default_voice": { "type": "string" }, "voices": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "voice": { "type": "string" }, "label": { "type": "string" }, "language": { "type": "string" } }, "required": [ "voice", "label", "language" ] } } }, "required": [ "status", "context", "language", "default_voice", "voices" ] }, "example": { "status": "success", "context": "default", "language": "en", "default_voice": "demo_en", "voices": [ { "voice": "demo_en", "label": "Demo English", "language": "en" } ] } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } } } }, "/api/v1/tts/synthesize": { "post": { "tags": [ "speech" ], "summary": "TTS", "description": "Returns base64 audio for the public IllyVoIP voice you selected. Text is limited to 2,000 characters. `format` must be `wav` or `mp3`, `sample_rate_hz` must be between 8,000 and 48,000, and `channels` must be `1` or `2`.\n\n## Before you start\n\nProvide text and a voice from the correct catalog; choose the supported audio format.\n\n## Response\n\nDecode the returned base64 audio using the response format and sample-rate metadata.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`, `insufficient-credit`, `unavailable`.\n\nSandbox returns sample audio. Text synthesis is available in Production.", "operationId": "speechTtsSynthesize", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/speech/generate-speech/" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "text": { "type": "string", "maxLength": 2000 }, "language": { "type": "string" }, "voice": { "type": "string" }, "format": { "type": "string", "enum": [ "wav", "mp3" ] }, "sample_rate_hz": { "type": "integer", "minimum": 8000, "maximum": 48000 }, "channels": { "type": "integer", "enum": [ 1, 2 ] } }, "required": [ "text" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "voice": { "type": "string" }, "mime_type": { "type": "string" }, "audio_base64": { "type": "string" } }, "required": [ "status", "voice", "mime_type", "audio_base64" ] }, "example": { "status": "success", "voice": "demo_en", "mime_type": "audio/wav", "audio_base64": "UklGRtQ6AQBXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YbA6AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAP7/BQD9/wQABgAFAAYABgADAAcAAQAIAAIAAQD+/wMA/v8BAAMABQAAAAIA/////wMA+/8DAP3//f/6/wEA/v8AAAIAAwD5/wMAAAAGAAEA/v8IAP//BAAKAAgABgAKAA0ACwAHAAsADgAHAAcAAwADAAAA/P8AAPX/+//6/+//6//u/+X/7f/s/+v/6v/v/+T/8P/0//n/+//8//v/BgAHAAMACAAHAAkABgAVAAsACQAOABAABwAHAAwAEQAQABIAFgAYABcAHQAhABcAKAAeABsAGwAYABIAGQAWAA4AEAD//wYA9v/9/+z/9//l/+D/4P/e/9X/4//i/9j/6P/f/+D/8//t/+//AwD7//z/DgAHAAYAEgAQAA4ADgAaABUAGgAcAB0AEQAaAB8AHgAiABgADwAXAAoAFAAIAAAABwD8//f/7f/x/+r/5v/Z/+f/0//N/9n/yv/D/9T/w//Q/8r/3f/T/93/3//j//v/8v/3//3/DQAIABcAEwAfAB4AGgAbACgAGwARACgADAAXABoABgASAAUACAAGAAcA/v/4//v/7//7/wAA6//2//7/6v/3//z/+P/w/+//8v/u/+//6f/4//X/8//5//H/9P8GAA8A+/8RABcACAAVAB4AHgAYABkAJgAYACkAGwAUACQAIgAPABoAGwAQABkAFQAUABUAFgAZABEAGgAfAB0AIgAXACEAHQAjACYAHAAXACEAIAAYABEADAAFAAMA+P/9//X/4f/p/9//3v/T/9v/yv/V/9f/0v/b/9X/1f/h/+H/7P/r//f/9v8CAAAABAAPABgAEQAUAB0AHgAmABwAGgAlACIAIAAZACIAHQAXABEAFwASAAkADwANAAQAAQD6//r/8v/u//b/6P/h/+D/2//i/9P/0//T/9X/1P/Z/8//1v/U/93/5P/i/+b/6v/t//P/+v/5/wAACAAJAAsACwAWAB0AFgAmAB4AGgAlACAAIgAeABYAHQAcABwAEwAYABMACwATABAADQANAAgABQAAAAYAAAD6//r/8//z//X/+v/q//f/6v/y//H/+f/t//L/8P/t//r/8f/2//v/+f/3//b/9//+/wMA+v/+/wMA+f8DAP7//P/3//7/8//6//f/9v/0//L/7f/3//j/8P/5//X/9P/7//n/AAAEAAkADAAUABEAHAAbACcAJgAtACsAKQArACwALgAxADAAKgAuACUAKQAqACAAJAAhAB0AFAARAA0ABAAKAP3/AAD3//b/7v/o/+z/5P/f/+L/2v/R/9L/y//I/83/zv/J/8X/x//L/9D/0P/W/9j/2v/d/9//6//0//H/8//7//r/BgAHAAYABgARABQADQAPABYAFAAQAA8ADgAOAA8ABQAKAAgA/f///wEA+v/4//r/8f/x//X/6//w//T/7P/2/+z/8f/4//L//P/3//7//f8AAAEAAgALABAACQATABYAFAAPABkAEwAWABcAFwAZABMAFQAVAA0AFAAJAAoADQAGAAMAAgAGAPz/AAABAAAA//8EAP7/+/////z//f/7//z/9P/2//v/8P/5//f/9P/u/+//8v/r/+z/6f/v/+z/7f/x/+3/7v/2//3/+//+/wAACwALABAAEwAWABgAIgAiACkAJAAmACkAKgAuAC0AKwAtACgAKAAkACAAGgAcAB0AEQAQAAoABQD9////9P/3/+3/6v/q/+D/3//W/9b/1f/X/9j/0P/P/87/0//Q/9n/1f/U/97/4P/n/+D/5f/n/+v/8//u//z/9v8AAPv/CQAEAAQACQAJAAgADAAHABEACgAJAAYADAAIAAgABAAIAAAABAAKAP//BAADAAQAAwD+/wAAAwD/////AwD+//z/BAD9/wUA//8FAAAA/f8BAAMABAAKAAEACgAFAAwABQAOABAADQAPABMAFQAPABYAEwAUABEADwATAAkACwAHAAAABgD///n/9v/2//T/7P/s/+v/4//k/+b/4//d/+j/3v/m/+b/7f/r//P/7P/6//3//f8GAAIAEAAKABcAFwAbABcAGwAfACMAIQAdACMAGQAjACAAGwAaAB0AEwARAAsAEAANAAwABgAAAPz/+f/3//H/8f/0/+j/7v/w/+T/6//s/+f/5P/x/+f/7v/s/+z/7v/s//H/9P/6//r/9P////r/AgD//wUAAAAJAAUACgASABAADwARABYADwAbABIAEAASABUADwAUABYACwAKAAYABwAIAAoABQACAAMA/f/5//v/+//z//D/7f/u/+v/7//o/+j/4//o/+n/6v/l/+3/5//l/+7/7P/r//H/8//6//z/AgAFAAwAEQAZAB8AJgAsAC4ANQA7AEAAPABEAEIAPgBAAEAAQABAADQALwAoACEAGwAYAAgABAAAAPL/6f/o/+P/3//W/9n/0f/S/8z/z//K/9L/zP/U/8//1v/c/93/4//p/+7/7//3////AQAIAAgADAAQABkAEwAXABcAHwAXABsAHwAcACAAIQAZAB0AFwAcABcADgARABAABgAJAAEA///5//v/+v/7//L/9P/u/+7/8P/t/+r/5v/u/+//6f/t//L/7P/3/+//8v/u//r/9//0//z//v/3/wIA/f8EAP7/CAADAAkABAADAAUABQACAAYAAgD//wYA+v8BAP3/AgD2//7/AAD1/wAA9f/4//v////5//r/AAD8/wYABQAIAAoACwAQABgAFwAeAB8AHgAfACQAKgAlACIAIwApACEAHwAnABkAGgAaABcAEwASAAwACQAEAAAA/f/9//r/9P/0//P/8//v/+j/5//m/+n/5f/q/+T/4v/n/+X/5f/r/+z/8//v/+//9P/6/wAA+f8DAAEAAAAEAAMACQAFABAABgAJAAcABQAJAAcABwAHAAcACAD9/wUAAQAHAP3/BgADAAEABgAFAAsADAALABEADQATABkAFwAdABcAGQAhABoAIQAaABkAHQAgABIAGAAYABUADwAOAAoADQAMAAkADAAEAAMA/P8FAPz/AgACAAQABwADAAIACwAIAAwADAARAAsAEwASABEADAATABIAEgAVAAoACAAOAA4ABQAKAAgAAAAGAAIA/P/3//v/8//x/+3/7v/s/+X/7P/r/+T/4f/j/+T/4f/d/+j/3//g/+b/4f/h/+v/7P/o/+z/7f/s//n/9f/5/wAA9/8AAAEABQAAAAgAAAAIAAgAAwAMAAgADQAPAAsACQAPABYAEAARAA0AFgAQABIAEwAPAAsACgATAAYADwAMAA0ABgANAAoADAAPAAsABgAMAAQACAAJAAcACAAIAAAABAABAAMAAQAAAAQA//8EAP///v8BAAAA/P/9/wEA+v/8//7/AgD7/wAA/v/5/wMA+f8DAPj/AAD6//n////4//f/9P/9//P////y//j/+v/2/+//+f/3//b/9f/z//v/9v/3///////5/wAAAAD6/wUAAAAAAP//AQABAP7/BQADAAEABAAAAP///f/7////9//5//b/9P/y//f/9P/v//b/7f/w//D/9P/u//f/7//6//3/9f////3/AAD//wEAAwAAAAcAAAAFAAAA/v/8//z//f/4//H/8//z/+3/5v/j/+j/4P/c/9r/3v/h/9n/2P/b/+D/4v/n/+T/4v/l/+//7v/3//P//f/8//7/AwACAAsACgANAAkACQAPABEACQANABAABQAIAA0AAgACAAAA+v/9//X/8P/s/+z/5P/p/+v/3f/l/9z/4f/f/9//2//n/+H/4//p/+n/8f/0//j/+v/9//3/AwAKAAoABwASABIADwAVAA4ADQAXABMAEQAIAA8ABwAMAAMAAAACAAAA+v8AAP7/8v/9//b/9//9//j//f/4//P/+v////z/9v8DAPf/AQAGAAAABQAAAAMABQAFAAYABAACAAoABQAEAAMAAAABAA0AAgALAAIADAAGAA0AFwAUABgAFwAbABwAGgAgABoAIwAjACAAHgAcABUAGwAQABcABgAEAAQA//8BAPH/+f/4/+z/6v/r/+v/7//u/+P/6v/u//f/8//r/wUA7v8HAAQABQAEAAcAEQAYABUABAAPAB0AGAAsAA8ACgAcABIAIgAhAAkACQAcABYAHwANABkAAwAhACIACwAUABYACQAcACYAEQAmABMADAAZACUAEwAZACsAHwAlACAAJwAiADgAJgAfACUAMAASAAgAIQAAACkAHADz/w8A6v8AAO//AwDx//7/+f/7/9P/1f/v/97/BADn/wwA9P8EAAAAAADz/wkABAAFAPr/HgAWAPf/3v/7/+j//P8MAP7/AQDo//3/9v/y//f/EQAhAOb/xv/v/xgA6v8HANr/4v8CAOf/BAD8/+X/FADs//7/5//O//X/HwALAPX/0P/x/7X/FgDd/+j/FwDt/93//P8AAPD/t//+/wYA0P/q/+3/4f/J/73/HADh//j/KgAMAPn/IQA/APP/LQA4APz/AwD9/y4AOAAZADkAt/8WADAA5f/y/wsAtP8MAMv/GQDY//X/6P/j/+T/5f8TAAwALQADAK0A8P8EAN8AigBwAFgAOQB8AD0AWwBmAB4AGQDM/2IA4v/c/+T/6P+7/9b/m/8AAJf/q//M/97/FwDH/+P/LgB6ABAAkABXAJIAXwC9AIQAnQCtAIAA9wAYATIB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3v/Y/9r/4P/t/+r/8//+/wIACQASAA4AGgAlACcALQA3ADYAMwA8AD8ANQBCADMAOgAsADEAIAAZABIAEQANAAAA9//6/+z/7f/v/+D/4f/X/9j/1v/R/9X/2v/Q/9L/2f/W/9//4f/o//H/6P/4//f/BQAGABQAFQAgABwAJgArADYALgA2ADkALwA6ADQAMgApACsAKQAmAB4AEAASAAwACgD7//j/7f/v/+L/5P/a/8//2P/U/9n/2//a/+L/4v/t//X/+//9/wUACwAPABIAEAARABwAGwAYABUAEwAUAA8ADgARAAEAAAACAPr/9f/7/+7/9//w/+//7//y/+r/6//s/+r/7f/y/+v/9f/s/+z/7f/1//L/7v/v//L/8P/y//L/7v/u//X/9P/4//L/8v/7//b//v/3//3/+f8FAAUACQAMAAcAEgARAA8AFAAbABEAGwAWAA8AGQANABYADQAKAAkACAAIAP//+v/3//v/8P/z//D/7P/t/+r/5v/l/+n/6P/o/+v/6P/r/+j/7P/t/+z/+P/5//z////+/wcAAwAFAAgACgAJAA0AEAALAAwACQADAAwADAADAAoA//8BAAAAAAAAAAAAAAAAAPn//v8AAAEAAAACAAYAAAAJAP3/BwAIAAIACQAGAAkAAwAMAAIAAAAHAAoAAAAEAAEA+v8BAP3/9f/7//b/7//w/+3/6//u/+3/6f/u/+b/6//l//D/5v/z/+j/9P/z//b/9P/+//3////8/wYABQAFAAUADQAIAAcADwAJAA4AFgAMABUAEwAWAA4AGwARABcAGAAYABMAGAAYABQAEAAOAA0ABgANAAcAAgD///r/AAD///f/+P/t//X/9P/u/+n/8P/o/+b/7P/g/+j/4v/o/+r/4f/p/+v/6P/k/+7/5//w/+j/6//o//H/7v/s/+z/6v/x/+//9v/t//n/8f/3//X/+v///wAAAwAFAAcABQAKABEADgANABoAEQAaAB0AHgAZACEAHgAjACMAIQAdABsAIQAcAB8AHQAdABUAGwAZABYAEQAPAA0ABQAMAAYACQADAAgA/v8FAP7/BQAAAAAA/P/8/wAA+P/+//n//P/2//b/+P/3//3/8//6//z/8v/0//X/7v/2//j/9v/4//f//P/9//z/+/8DAAIABwAMAAkAEwAQABgAFgAhABoA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CgAUABoALQAqADoANAA4ADwANwA6ACsAJAAXABYABAD5//L/5//e/9r/1P/H/8z/xP/E/9H/y//V/9X/1//i//H/8/8CAAcACwAfACQAJwAyADoAOwBEAD8AOABAADcANwA4ACgAKAAkACMAFQAZAA0AEgAKAAkACQAJAAYABgABAP///f////b/9f/x/+3/5f/o/+X/4f/k/+P/5v/g/+f/4//n/+j/5v/q/+f/8//1//v/+////wYABwAQABYAGgAnACMALQAxADkANAA4ADkAPQA1AC4ALwAqACEAGQAWABMAEgAFAAQABQD3//7/8//w/+n/7P/n/+n/5v/n/+n/5//n/+f/7f/z/+7/+f/v//L/+P/7//v/AwD9/wQADAAEAA4AEAATABkAGwAhAB4AIQAfACQAGwAjACEAGwAYABQAEQALAA4ABAACAP/////4//X/9f/v//H/8//t/+z/9P/s//H/7v/v//D/7v/t//L/+f/6//f//P8CAAAACAAEAAEADgAMABIADgARAA4AEAAYABgAFAAZABkAHAAfABoAHQASABoAFwAQABAADgAOAAsABAAFAAAA+P/7//3/9f/z//T/7//0/+r/8v/p/+7/6//l/+j/6v/u/+7/7f/y//b/7v/2//T/9f/4//b/9f/9//r/+//8/wAAAAD9/wAAAQAAAP3/BAADAAAABwAIAAMAAAAJAAYACwAFAAUAAAAAAP7////5//r/9v/x//b/+P/0//X/9v/y//f/+P/z//H/9P/v//H/7//s/+r/7P/t/+f/7P/l/+L/4f/e/9n/4P/V/9T/z//V/9P/1v/S/9H/0P/a/9//5//e/+v/4//m/+L/8//0//7/7f/p////9P/1/wIACQAKABQA8f/l//z/CgAdABsAIQDk//n//P8jADIAGAAAAN//yf8KAC4ARQBIAN7/w/+3/+//1/+S/7T/2P/a/1IA9P83ADcAeQB+ACsAIgAwAJv/tv/8/7oAiwBOAFj/a/9HAFAAsgCqAGwApgA+AH0A3v9l//P+CP94/wMA0f/X/8QAtACvAAkAaP/F/5r/x/85ADsAMgBv/8n/UQD9/ywAev++/+X/pwC2AJIAkQBDANEAWgC7AMD/Yf/I/+X/pQDMAB8AHADb/1j/3P7+/jb/6v8iAAoAMgD3/xYAZ/8aAD0AUwCz/zj/ef5U/x4A1P8AAN7/vP+v/8r/lQCeAF4BUgCR/4z/a/87ALoAYQB6AHEAnwBDAGcAJgD6/7L/4f5M/1z/SQDK/xkAw/+g/0cATwDXAFcA1P+p/7f/BAC4/zIATABAAD0AWv+t/4T/GwBXAFIAt/8i/0f/xP8LAFAAAwBz/4j/nP8/AH0At/9sAK3/PAC1/5r/vf/u/8YA5QAxASQBkgBUAAUA/v+DAAcAOgA2/wL/af/x/4kAAQEYAekApAAxALP/Mv80/9j+4P7p/jv/hv9Q/4//6v/C/zQAWgDT/24AFABJABUAYwCOALj/YgA3/8X/BwCH//P/w/9CAEQAHwEzAJb/agCc/zUAlv/f/3j/Wf9NANr/0f81/2D/FgC3/4QAOwCP/7v/0/+TAKsAfABz/1YAi/8XAHwApwCNADEACABMABcBMwAcADwAjf8jADL/Q//I/x7/SgADAC8AlwAFAKv/Rv/E/2YA0wDE/6T/Rf9p/0kAcQBrAO7/LACk/6r/FgDI/2YACQCTANP/EQATAGv/JgB1ABMBgf9X/4P/jf/K/30A2wBHAEL//f4gAGAASgESAN3+Bv+j/xsA1f++AAAARQAPAHD/sP9yAIAA0ABK/07/M/+M/+f/bQBiAEEAbAAKAK0A0wDn/8X/of8PABkAof8kAP//oQCqALQA3P+6/4UAsADHAKD/eP89/7b/lwCG////Kv+r//L/cAAKAGX/L//y/1EAGwD7/0QAtP9GAHwAWwBSANv/dAAxAEAACACAAGAA/f8eAJcA2v/7/xQA6f8bAND/MACL//r/cP82/5n/NP8N/9b/RwDJ/7z/4f8WAGQAVAESAecAQQCe/5b/z/+o/+3/Rf82/6H/Mv+f/1QAnP9n/83/rf9LABsAOQAMABkAqP9rAGwAhgAtAFkADwAzAKYA3wBAAK0AQQBOACAADwDB/wYAm//W/8P/wP/n/z0BwQH6AZgCWQJHAncCLQJJAsIBXgGQABUAfP9Y/+H+nv5M/r79Uf0I/dj8pfx3/Gf8H/xA/G/8mvwR/Zb9Mv6w/lP/HgDJALgBRwL5AkwDdgPeAx4EVgR3BHwEIQSIBPcFvwZoCCMJtwhsCOsGpgWLAzYBzP5p/KH5B/gu9v/0mfT28y30/vTL9RT3f/ik+cP6wPtW/Fj9EP4r/yMAiAF9Au0D3wQhBhIHMgisCAcJ4QizCHAIRAiSBxkHQAZqBosIFgt0DfcOkw6UDL8J3gUtAYH8Mff/8enth+pU6OTnmejw6XXsxu658Vz0NPd9+Zv7Nv23/kMA/QHKA3AFiwd7CYgLSw2TDjIPag/1DhMOkwxFC8oJ4QgYB2wGdAVeBXQKYg4WE64UDBN0DXkH8f5T97DvMOkQ41XfWN1m3dffveOo5wjsEvCS8+n2Qvqt/OP+eAB4AZYCigQ5ByMKig37EJoTrhUlF2IXDxfUFasTEBHhDYAKeQcdBVYD8AGBAacGNAslENAQcw15Bo//GPcH8PHoQOO73gLdQd2k4Dfl8OlW7uvxS/Xo9zv7Y/0PAKAB5QJ/BOAFowhNC9ENkhBhEnYTOBS5E3ATwBGID8wLdwisBdgErQMFA4MC3ALQAyAQsBeYHuwc0BR1COz+e/GQ5wPeYtdg1BDWn9gO34PkW+rq7v7wL/L787b0aPcd+uX79v+4A0oHkQvVD0QT+Bf8Gucc5x1lHTsbZxmcFvoRVQ3YCsEH2AZMBdkE9gJHBH8Qghe+GycX6QwPAaH2GOrJ4JLYoNXW1FjX69oE4Ebj+uVL5yToEuj16f3syvMu+iEAuQT5CB4MZg+5Eq0UbxhMGw4ePB9JIOofNx6nGq4V4BANDmgLoAiIBq8F+QScBKkSrBiOG7gWXgxx/3b0wOVv2j/UG9I30yDVQNjs3N7h1+O54zTkNuTI5oHsCvKx+lIBPgfEC+cPchGCFLIWTxmOHBEgkyHpI0IiLyENHgEZsRIjEA8MRgsgCLsHPwYpEC4Y1xpXGFAOTwP09xLoJNs503LRwtOK1dLX7NzO4L7i0OEo4TXgj+NM533uLPY9AGsFJAvPDtIPmBINFNsVShiYHJUgciKDIxIjfB/cGxkWzQ/hDZwLYgn7B6MIWgVdEkIcVRzGGd4PMgWh+Gnia9UG0sTP4NDE1GLa3uH248/jsuF34Xbe+96S5CjsXvVQ/7EHeg2KD+cPahGbEvQS8xcgHYogESWzJcslYiHyG1AWhRCADWkLhQgGChIKcQXvFCUfpBmbF0UMegGG8gzaTtHN0jjO3tKD2MbeVub+5fbibOOW35ndqN955WHwGPqeAykLBQ/RESkRZBD2Eh0V5RkuHlYiHSW1JpUjdh6oGc8R2A0IDBYJ2AeSCTUJ6QXUEisenhWKFH0J4f3W7wfXP9Al1J/OKdTk3A3jdemf52vlC+PR3dLdoeDI5RTzffwaCBYOzxByElQSCA9HEKYVSxiUHVAj3iXTJBkjCB1hFLAPXQpACDYHDAjaBzEK0wMiFR4eFha5EJ0HrPhk63DRVNDB0mTS59cj4r/oauwR6lLmGOEi3bDbwuCx6LP2HwIBDFcRkhSsEewQUA5BESkUhhrrHpomCCfxJlIhIRwzEvsMIAnPCBMG0AjKCXUJOgReI9MVuQ5fChUBIe/+27LOWdP11GvUiN4C6KPsrOnz5dHhrOB52z7gf+qa9F0AZQwGEG0UkRF9D4oNGA9UEDQXphxlIogjkiNbH0oaWRGdC/8J2QTqBCQGXAmMBqwImQbQHawXKw61DsYC2vMj487SVdY216TUTd9p5Lbmyeew3/nbptor2Rjbe+MR8YL6fgTZCxsQChCHDQgObhCEFcIW4SIbJyoqaCsRKTkmSB42GGgWeRC2DucPzw97CgAM1RX7E1ITgw4cC24ATPPd4abeZ9aY1qPSAdVN3fnYqtWA11LVadGP0rfXmd0+5WbwIPeR/1oESAfHCjYN1RD4FmAZtSSXKGUq8TBwLwMrQShLJoIfhRxjGssX0RZjEvcRHRdZExQSxRFbC54D3Pgj7Wfl292C2UvWOdQY2A7UyNMg0uvQ684E0CLS+NWX3qnkney39RD7Nv31Ax0HywoLEYMWRB5tIkYojC2FLjYuOC39KY0pmyYdJCcimCA3HcEc1x6OGjIYNBWKEMsJ8/4y+LPynehw4gPf4Nh12FfUftBK0CLN3s2mzEvN5tGz1APaUd8i5vPr0vGY98b7rwP+CJMOLhZTGwYi0CaOKakrgS3SLDos9Sr7KSwn+yQNIx0nHSEpHq8dzBbFEygL4QGb/vf09PAp6nLkc+LL25vXm9YH00XRL9DAznzST9J11eTYL9vC4P/jaunv7mPzgfogAX0G3QzJEbgYPxyNHjwkEiXqJ1optyjpKfwojigjKT4m9iWAJB0hER1wGDsUAQ/aCBgEq/yn90nzmOwP6bbjMeB33RXaE9eX1g7WqNXs1W/VlNhH21zdqeAk5RTpge3b8tL4V/xRAuEIjQxoEDEUHxnqGyoeZh9HIZcisCGZIn4gSx8zHXscNhmtFbkSgA8KC6sG4wMCA5L/VPpq+AL0q/DX8JjwLu5s68LtZu0t6zftte3E7Zjv1PAX8qD2GfkC+qb2o/gq+9EAwwTCA3UCugMuBIsFwgXTB5MJMggzCOMGmwb2BmwHmwXAAnQCNQaZB4AFwgCY/Ar97gCiBeoBm/68+lj8Yv4lAD3/uvqf+y7+FP+6/rP8Qvzv/v4A4v7S/HP/tP+WACoA5P5d/hIAuAOOA7n++vyjACEC3//WAR0DB/5s/QgB9gLcA0oCG/sC+mABswOEAwP/Qv6n/D//VwLrAkAAegAeAYX+7fpM/hYCYwTSBF//wPws/VD+qP3F/lQFbwUZAD/8mP3e+hT+CwaJAYb7of65AUX++v9LAhL+nvwM/yYBYgIwAHb9U/0tANMFygX//P74/P+pApj+RwEnAzwAZQLtBPf+Wvgk+7kAuQZcB0X+Kvmx/6UDHQBwAJwBuPqD+egBwQktA4z5hvox/iH/6gWgCF7+iflZ/UX81v7LA+kEIgT9Aj78efhO+XD9egURDBoJmvld8Zb4/gQFCasFVAGn+lL7gv2w/j0BqgPOABACrgGd/rj/uP2W+cn/4QRtAowC/AD8/+b86PmI/KYDeQUzBgwD+PmG9rH5kAPOCrUIrP3t9sL7bQAO/9UAowZgBD4AQv+r+0H3z/tzBJwKogf9/FL4RfzJ/qcDkQUwAWf5LPqa/vsFuQrRA4j5m/TS+kYGRwdiACz95v02/xADgwQ+/vb51Py2/t4ALwWRBY4A4vmT+JsATAa1AJD/GAI8+zT8jQQ5BQ3+W/5fAe3+xfvc/ncCtgSyBMgAgPcv+dIFpAju/+T5tftSA7oEWgFz+8P6qAH1A2oAwAEqAwP/gPpf+6T+agPJBL8BYv2W/b8ASAOSAFr8dvnP/jsF4AJNAisGDQBP9Rf2cgKOB2IJCgPb9tr0g/39BsQL3QMv+Ub61fu3AGIGRP5m+bIFvQfc/tL/Gv7H92T5iQPwCU4GSwIu+Ff3aAInBt3/y/6W/q//lgOjBDb8Ffjx/oEDpAXLA+n/Lfws/Mv7hv6mA6gEIAW+ADH54/pcACr/KwN6CNv+6fip/CkAcwGSA3QBWQCQ/Rr9FP6H/rj/mwOPBLMA5ACk+/r3V/3HApoFaAfTAPL4XfqnAJr+KATVBREAFPzL/cn+xQHG/3r/uQIEAn8AGP68/Sf/0v7KAaMCRwCdALMB4P2z+qIBmAP8/yMCsv+Y+kD/gAXIAmb9U/+j/PYAhwShAYX+Lv2g/tQAIARS/zr/AAHY/nX+jgLbAZ78LP+XAPv+1AF3Auv/nvzO/+3/bf7SAfEB6v8y/LX/MgGzAGcA6v+w/joAnv+6/1AAqAB8//b+lQAnAQsBGQDE/s/+DwCmANgAAAHJACr/PP/F/1P/SAJ/AC8A2/8+ALD+ygAiAIgAewB0AI3/O/+JAC4ANgCO/4X/OgAnAKAAXP/s/5j/sP83/xcB4/+T/7YA1v75/4T/2gAxAJ7/HAADAHL/lQCf/wIA1f8fAR0ABwB8/3X/TwBsAKz/rwCH/xkAX/+BABoAo//P/xsAJwClAGYAlP+O/2//vgC7/8//mwCI/43/m/+G/1D/0P8q/6P/eP+B/+7+SADR/nkAMf9PAGf/DgA5AHkAYf+TAIb/egALAJ0AewDD//L/ewBpAJwAXACGAGkAuQBwAKsABgDq/wIAqgCn/9b/EgCS//7/EADE/04Ajv9EALz/SwCX/9f/t/+a/5H/mf9J/2j/wv9+//T/ff+S/6v/GgCs/9P/HgCb/9b/3f/e/+r/bQD6/wIAQwAnAPn/lADm/1sAZwDx/9r/SwA7AOn/iwAKAAkA9P8qAD4AagAfAG8AJgAgAGoAmQBHAI0AHgAWAJUAWABJAIMAegBLAcMBpQGOAckBQgEdAUgBBwFrAPP/5v8v/wH/AP9x/mz+q/42/rb+df5E/pD+lP6t/un+t/4c/wL/Gv+B/7v/x/8KABwAMACfAOAAzwDwAFIBAgFZAQUBZwFlAVsCFAKYAj8CJAJ2AiICWALAAVcB8gBoACwA1f+b/zP/Kf8T/93+Kv/Q/s/+s/7Q/sr+Cf/q/vz+s/7+/g//Lv9K/3z/ov8HAA8AKwAUAG0AvACuAOgAxQAFATgBAAIlAwsE0AQ+BW0FsgXiBWwFTQRGA/cBlACb/9r9o/yl+7/6K/qo+ST5IPkT+Yz5YvrB+ov7PPxr/XL+pP9qAL0BmAKRA0YE0AQvBTsFUwUEBdcEkgShBH4EWQROBE0G8AeaCloMgQydCz4KQgeYA+z/1Pqf9kbyEe+07O3r2esV7ajuqvCb88r1i/hp+tD8N/6A/4wAgAH2AkUFdQaxB88I1gmAC/oMSA63Dd8McQxrCzwKKAmWBnIFMwUPCiQMOw/BDnsNhAscCuUEPv8F9wnwUOnq5HrhxN8D3z/hu+PS5w3stfCK9BH4Dvtp/R3/SgFMA28FlwdkCiINSBCIE7wV3xeAGI0YexeWFWkTIREqDvIKqwiGBn8KGQ0HEdAR8hC7DrQM6QSH/MrxzecN3/zYf9Lzz5vQ79OE2K7eOOTv6QvwLfWp+DT80v0hATUDHwYnCbUNchGVFvcZ8B0nIKIiUSLEIOcdKxvQF1ATrQ9QC1MIYgfuC7kMWA8ZDzkOlAs8BxD+R/Rs6iPhI9mW0SrNNMx8zl3S1dc23SjkJusd8SD1u/nq/I3/vQIJBQII7ws9EBIUcxmSHMAgySMqJPUkRCNZIN4dghmvFBMROQ0JCqMM5AzGD2cRFxBfDx4N5gQ7/Bfyo+fH3qrVMs7fygXKecy0z4rTatoO4c3mnOyx8BX1svlD/Cn/kwLpBq0KlA+IFFwZBh64Ih8lUibJJyMmxCPlITodGhlUFa4RiQ7IEpURPBPkEqMTlhEHDBYDV/qv7/3jNdkBz1fIUMZSxFHGp8p50HLXN9+R5WfsifF/9936Ef7wAL8EJwjCCtUP8xPMGbcdBSPqJhkqHCvRK6YqyCiVJAghfxwaGCQY6xQpE5YUcxJpEZ0OAgkFAub69fBO5vPb3NLly9DE4cHcwX/Cpsb5zG3SFtrK4aLoXO/H9C/6h/6hAmIGXQqrDrcSdRj1HFsi4SaUK54uXTDMMfswqy7SK1cnmSNWIVceHRpKFzIVXBNqDOoGxwFN+QXvxuSX2kvR2sjKwMa7SLnguNC6bL62w3HLatOE2pviC+po8F/2jvtnACsFVgvZDwwW5ht/I7cpHjBbN907C0AAQpZB5kGZQG48xjf6MdkrfCbBIeka7hJ5Cm8CVPrg8TbpEuBl1m/OeMf2wTu+/7sEu1+7gr9sw4DHos5b1GPa0eIB6nTwxPYn/dcDawqpEf0XjB3LIqgoXS0xMPIyBTSXNIo19jS5L4gt8i14K/Ul+SHoHAcWxhCwDGQGMvzl8insPeVa3aLXg9JzzRrK9cn5yNTIzcx50CrTa9Z422bf9eMQ6ujxufbc+uoArQSnCocUVBuyHZ8gLiU6KjMtJi7yLWIuETAHLX8o/ScBJwMkGCLAHWsUlAzyB8YBKf1W+OjwGegf4FLZT9a91bDTEc9yzUPQpNGq0ZzT4dcp2+rflecA7DztnfLE+igB6AevDlYQexPCGnYgzCD1JJ0nOCZCJtQptiujKzMlBh/BHnId9RsbHccWhAgGAYn/HgBq/uf2LOoD41XjF+fW5CXf0NgD2LjdBOBY3fXcjd3x4VXp9+yt7WLwxvVk+eX+8gUJCOQFjgtIGEIcLRZ6F/Ya8RU7Gesm1yo4JZcckRPrEdQWYBs6HPMVVQpsBMcAU/v1+mL6fvOP7yPvAOon6KXlE+HJ4LjiQuQn6G3o4uV26GXoSOnm8Xb2kfaz+r0CBwVxBUwFoAJCBbkS4BuLHFQcLxGdBYMMYxknIKYjiR3uD9II1AVIBvgNXBKbCp//rftE+WPzCvLN9V71efIE7jboSem67IfsJunO6Dvu0PEo8wv2wfL279T2DfzLAB0H/gfEBKMD+wXMDHsSLhInFgkUawjEClgYzhwtGYISKAoHBbkIyBJmEXcGuP5v+8H3UPhG/N/3BvWl8vrrTOrR7qbugO7Z7rft9+w88c3zn/RW9ur30/ei/QkAIwH1BC4GGAc+CbYKugvMDdAO7hM2EV8MQw7cEioSOhMeEeELpAi/CPAJnAd6A17+Qfo5+hD7tffv8ijwcO6i7ujuku6z7vru2e147ULwx/Fe9E32JPlL+4L88/24AK8ENgazB1sJzgpcDCQPng9oD7cP0w74DxYSehOEEI8PcA1pC3cKiQiNBTMExwDN/AD6Evj39ADzr/I78BTuu+2l7V7t2u0y7wnwCPFg8tDzrvVW+J/7LP1i/1EChANKBX4IRwpaC18NFw68DkYPcREIEeoQgBDmEHQQ4RDwD7UNjgzVCYcH0AUmA2X/iPyG+U724fNu8WXvvO0d7Brrleq66tXrX+zC7fvudPD88j71nvdI+mb92P98AggFPgeGCc8LVg2qDp0PZRDtENIRbhFGEscRnRHNEOIPvg6MDRQMxglSBwQFcQJi/0n8j/mH9vPzjvFh75PtQOxE687q6+pO60PsLe3b7tLw+fKQ9Q345fp8/VYACgPOBS0Ihgp4DNQNOA8DEN8QNBElEbcRTRHJED4Qtg8fD1oOLg21CzcKPAgRBq4D7AAd/mr7Tfiv9eLyVvA07kPsGOsj6tjpjOlR6hPrseyM7qbwLfPG9cz4o/u7/oQBtwSCBwMKXwxCDhUQTBFGEtASQROJE1UTkBMRE9sS8BFFEfYPwA5TDUQLqwjOBbMCSf/4+0r4zPRr8U7ukOsu6XXneebd5c3lgebA50zppes17irxffTI9yL7r/44AnkFfgh9C9ANHRDhES8T+xOaFK0UmRQHFWkUDxR1E+kSYhKxEXcQHg9kDbcK2AeFBKAAtPyy+CX0EvAh7IboruV549XhF+Hc4I3hA+Me5cTn/upz7jXyY/aJ+sj+8wLKBrsKJQ41EeQTJRazF+IYoxmlGVsZ4hhqGA8YYxftFp0VqBRBE2wRMQ86DDAItQOM/uL4avO+7UTocuNG39TbudmM2HzYn9mx26veROKB5jjrN/B99a36w/+sBGkJsQ2oEWAVLxjlGrsc8x25HtgeUR5xHegbRBvdGU0Y+Ra6FUEU8xI1EWsOqQv2B3wDfP7K+Lby2OwT507hltyE2JTVBNR50yvUMtZL2QTd2+EX57zsjPKJ+FT++gNcCVYO4hLjFmQaLx1sH+8gviEVIn8hbSDOHgkduRt3GqQYYxdbFegTGxLUD/QMjQnDBFj/bfnD8ifsuuVG34PZ5tRD0f3OUM7+zhPRldTJ2B/eJeRe6gfxr/c4/mAEMwpoD18UsxhwHKsfGSK5I+skUSXZJBAkhiI7IP4ddBx/GkgYxxZqFM4S1RAzDhgLqQeDAij9Hfco8J7pHOOY3PfWo9LizlrNAM3YzZ/Qh9RC2QTfWOUJ7P/yz/lvAKkGSAyBES4WLBq4HWAgZCLPI28kjCTvI6oi+iDPHkcc+BqZGWwXIhY1FA4TmhF1D1gMPgktBE3+9vef8H/pYuJq20PVStCrzNrKmcrMy9POJtMs2CnequSN64XyXfm+/90FiQuvEEMVeRkuHT8gwiJkJIIlMSb2Je4koyOqITMfTx6wHFAa0hi6FtsUERNaEFkMigiXAuT7EvUu7Y3llN5r10HRR83jyQPJ2Mn7y9DPONX52pLhveib7632xv2ZA2oJZg44EzMXIhseHtIgiyIDJHwkvyQdJLci6yCEHgIcUhsaGm4XNhYjFJISkRBfDSIJ3wRM/mn3XfCE6Mfho9t41SvRyM4wzRXOQdAl09PXbd3i4nrpju949UP8zAG4BvkLvhCIFHIYmBuJHQIgByE+IY4h4CAhH50dDBuLGKUWBBi5Fj8V5RNUEooQZQ7ACqsFOQB1+InxPOrR4uDcr9d10oLPjs6kzj3QddNm12jc5eEU6FnuoPTc+ocAUAaVC8IQIBWFGZscIiCkIgkkBCUAJQgkAyO6IE0dbxobF2MTxBPREi0R9w9FD2EMqgsQCMEC1/0v97vvq+iB4YrbcteV057Q18+L0DLSZNXd2X/esuRO6kHwx/Vi/AECtQepDHERQxVaGVccyx4ZIcYiJyOeIhchYyAeHj8byBeQFYMS0BPsEy4TAxKlEIMOIwy8B5cAEPtW9E/sh+Qz3rDYS9WF0XrP5s7Z0D3SftXG2QDfgeTN6kXwDvdF/eQCtgi3Dp4S3RcsHAUf5iEiJIokZSX1I70hrR/XHSQaaxZiEwIRhg5jElcSURHaD9QNbwg5A/f84fXv7jrnYuKW3FnZddY1193VldW61hzZFNyr4AHlTete8Sj2Jf0fAtUGcgw6EdgUVxnpGy8foSHCIcohnyH6H8YccxnSFjsUJBAZDcoKMAlEDK8PiQ9GD7EMAApdBPr7YPRq79vnx+H/3SDbRNhi18DX2tfK1p/YmNtK4G3k8OlF8h/6E/8eBNkL4hCYFJ4XFx1DIIAi5SLoJDUlXSNnHkYdkxenFAgQgwwNCYsGEQTtAnQMwwyKDA8LnQiX/in3f+yq6HriIt7J3ILcSNzU3U/aA90D3tHaS9ws4YvnzOwS9Wf9iQZPCHAOtxMKFu8YnxwdIW8ivSOtJTUmuyE0IAQcVBYhEFEOdQkbBVwDPwJV/tX7Rw4OCHkHCgy7CaD6fPOz7WPplNy34MHjz95I4LLm3uKV4Xrh2N+34Xbi8+hV8qT5YP81CZELkA86EMgUFRZ3F10cDx+oH5AiwCCOHmMcTBXOEfoNwAlOCJMFqwTvAqv/1grcDqgHAxP0CXX+CfgN7IDlBuCe2wbi89464UDlOuT74DXi99zl3Q3gIuUH6zf27f6VBZEJww9IEVAQYxXfF0oaVh+BIoMk0iOgJL0f5BmiFkAQ/AoUCxEH1QQQBUYCev4BCXINoQVuDVcG4Pe18EPmrd8l29TaU+Ll4cjj/er16Fnk8uNd4ivhqeLN6/nzuvzLBCAMEA9lDyoPkhB5EYsUfhhTHi8hxiOHIsch5RypFU4RRA3ECPAGmgiNBQwEDQVf/SoJfA5KAF0N5gKG9U7u4eI94b3azdkc5s7kWOZb7Y3pkuX44pLggeHG4ivsRPUt/mUHQg3fDtIPew/cDScQ2BPwF3UdTyGFJLAkZR8HHmoWWxAcDMcHKAjxBXkFtwUBBNj+/P1CExoCowQyDcz+afA961Dkl9+51bbjU+bS44HrV+4i6PvjceK24Kbf5eR+74j4zAC3Cc4O8A66DVQPmAxZEAMVDRkVIHoksyR+JDch6BoPFUoOfgs+CnsHcAhJCNoGKAOHAGATrgQ5BHEKA/1Y8ejnOeQp3pjXs+Aw547iPurE7JHmqeIA4mTfTeBm5Fzv7/d//zkKeA0MDh0PiQ7yDXgQARS/GnAejSKqJRIkNCBoG+kVNhBACpIJFwlFBpwHNgYWBYj8ZgrvC+j/dgrbBZL19e/o5KnkW9nw2g7nfOS15p3t0Orh5jvheeEE4KbgJOmz8qX8DANJDLIO3Q2TDV0ONw3UERYW2hspIZQkbSTMI6kdmBmQEh4NrAoUCWoIBQcVCBsGygFL/0cSXAOkAzILv/7Z8UfryORf4LLX/uFr5vzjfur67EPorOPk4bDfQt8s5CTsSvaG/iMI8gseDj4PywxaDf4PBxRzF0AfbiN+JQwlWCI0HQQY6BAgDTsKVwm4CFEILQYCB0v+bQkgC/P/xgqVA9D2DvEj5zbjstuy2ibl7OId5gPr4+ot5gridOEn4b/gI+fQ8rr4GgN+CdkNlQ47DogNyg+UENQV+BplIHoibiXcIuEecBoUFIcOjgvyCBYJhQdRB1cHvgFaAXER3wIfBlELu/6P9VHs4+f733zY2OEd5InhDumr61vmRONs4QjgE93e4RnqKPJi+38ENwqGDT4OpQ7NDusPDhQqGXMecSK1JkImMSR2IEEajhRmEO4KWwpMCc4GEQeIBMsBTP3hDuMBcAKjCob+DfRC7a7njt9l2JjhdeMo4ZXpxeuO6HDkUOML4zbem+PU6yjyZvuyBA8LrA38DaYP1A9mDrkU0RcPHJci3CM5JjcjpR+yG7gUJw9KDecI+giqBpoGdwXGAMX+eA4fAf4ECwv9/xr4SvAF6nfhStoM4LPgxN7M5tvoXOWt5B/k9t8R3+Dhnujy7Uj4DAHHCPILKQ92EGQQ/BG6Ez0YAB3uIIIjOCZGJB0hKRx5F2AQpQ0HC0AIMwciB1EFswBfCb4IKwMbCyUFWPrc9lHsyeZ93YjeOeHg3Lnjdebe42/lPeNJ4CrgDt4e5Orn4u/i+EUC3wYdDB0QRBDAEakTsxdHGtseuCPPJUUmcCfPIb4fTRlIE4cQoApGCeoG/ATcAtIB/PzoCnwA6gY5Csj/Lv2o9LjrjOMj31bfzduz37fi8+J+5KLkV+P/3xDhruAG5fHo8PLE+63/0wk4DvAMuhIrExYVxhgfHJwgByN2JbEmtCLKIigcWBe7EqgOWgvyCJoGrwW6AtUBSgvbArgMpwgsBPr/yPWW7RTm194F3znb4Nzo4DvflOEW4zbfYuCZ3m3eIuMq51HvpfaK/wEGMwtDDtoR/hMXFnwZtx3mIG4jqCa/Ji8lRiMXHo4aChRIELUNBQmAB6AGpQBhBKcJZQLpDUYIGQTTAUX1Wu7L5v7e294O2vrd997J3jPiY+Ll323giN/n3jvjyOc67c74uvzbBVoK2A3WEXESBxf7GRIbzCJOIh0lAye7JCoipR8EGW8V7w+GDbcITAepBIAClv9BBT4EJgW6DKAFLALU/SnzB+yp43ng/dxw3DLfJ95K4tPim+GH47ngx+DK4n/mserE8rH7ZAAKB5MNIA+LELYWoxcGGZcfASFiI3MjhCaGIpQeRR2hFncRgg6KCsgHIATQBMgAbv2sCwEBQgopC/wD8gKk+DnvaOsu37HgTNz12+ffFd8+4hvi8eJE4/Dem+Sm477nf/Bl9U/9cwXCB0oPJxGKEtoXqBmbHDsfHCPvI0wkASN6I8gb/hmKFTYORw24CJIElgUeADr/rwVoA6sF/Q6SBMoEDACz8gnv2ONX4RHdHNy83d/e1d9D46Li9eEI4nfj8OFW5lLtiPEl+ccBIAZ1C1IQgRG2FtsXQBwYHlIh9iNfI5UkjyJVH7IbJheSEWwOHwpXB94DdwPR/lP/9wm8/6kM1wufAlwGJvpB713sIOEa3pzaudsh3JjcLeH04cXhFuPN44XiIOab6s/tpfbb/QsB+QqNDb0QMRY5GH4b4R1qISkjuiNqJVYiISIpHiQYDxbuDtQMAwgcBdkCUwEI/AEGqwMgBH0QdQZvAswENvJo7l7m1t1I3BPYp9lk3AHboOLq4E7jauXw5APmZ+tE7fHyOfuM/uYFcQvxDlAV2RaHG9IeNyHqIt4ioCZKIjAg1CABGn0U3hKHDH0I1wRoA9D9dv5U+2oBTwQFAjcRWQZ7BCYEofYc73/m0eBE2mjXPtr42Cbck+DE46vjYeaT6H3omusW74L0O/nz/dwHQQk3EEkWhhjqHOIgEiInI4UlOySyIYkhXh02GHwV3g/TCnwIugORAN7/R/so/N8Me/riD1oP5/+/CzYAeOwW8YrguNiV0/7S5dHe0b/ant/74Trrb+3b8NHzvPWG+C/5pv0JAbMCrwpWD4UU6hn3IPAi+SUPKdUmaiXaI98eSBp8FcwOJQwQBtYCwf+t/bH8qPj0+pEMVflJDuQRgv4aCwACyOsA8NThP9aW1CzRrdG10k/ZZ+Eo5IfqxPF+80b0+Po9+i364f+ZAeYCsArADg4T6RvqHrcjtydbKE4okSaHIxceYhoTE3YN5QhwBMf+Y/9l+h/7nfj4+SkNO/k1DsASNf6tCr8Ev+iD8FPi/9HX08nOIs0c0r7XpN8c5entj/JJ+OX4Xv01/jf+hf9fAxEFgQjzD3cUChqyIJQlGif7KSsqWCbwI8EefhneEDMOQQbgAM//X/sh+Ir6GPe899AMXfhtDJwSFf5XCewD1+lQ78Hhy9Ir0nPPV80X0f3YQuJI5cPwFviW+bv+WQGpAO0ATgNPAjwFlglZDc8T8xlDHigm4SU2Ko0pFCUnJCIdqhY7EbgJ9AMfAQH6fPpi+Gf2Hfet+DwKyvjfDUQRqP/bCgcFyeuX8aTjH9Xc03bQ287/0JrZEuEd5R7xvvWl+d7+LgAIAfcB4gGNBBsF2gm3DbcTCxncHv0jxCX3KFYovSSfIjcc0hb+DmsK0wI7/7r7gPhG9y74NvWj+EALRvckDqgRPP0IDSYDaOui8pXiGNXN1GvQ9c460o3aV+EW517xFvgv+tz/owJGABcEiQPRApwIegh+DjEUEBhrHlEjtCSfJssnsiJIIVIbQxUpD6sJrwIc/4r7aPjd9mX3g/VM92cJvvefDGEQHwGgDGEFFfI+9iPmxtty2fXR9dHL0j3ZV99m5PjvVvMo+vv+vf8dAw8DlQJ6BV8EAgkaCykQ9BXzGF8g8SF/IwUnSiL7INMd5hRqEyoKWgRuAgn8+fhF+UP3NvYX+TAHw/mhDEUQ7wEXEN0GiPX5+RPrsN5I25fW8tB00pbYOtw+4b/srfBW9pD8C/+7ADUCyQLWA0AEtAalCkENExKhGGIbsB/YIpEkkyGiIlcelhYOFucMMQeABJL+zfuM+bz5vfee+NwI5vjWDekOpwJvEiUGcfjR/kLq6uOM3zXUMtV80l3VNtvw3yPnBfDO8rT7ZvyZAGoBogHdAl0DLAQpCGUK8Q9gEzcaxxzVIDQkfCEIJMoeDxtSF0gQcwoqB9b/RP4A+6z46fkh9xYCGwCKALgVugQmC1cVIPtoAxr5X+dR6KLbMdXQ1UvR8tfn2S3gkekn7cH09vrH+8T/HwAMAB0AlwBBAnsDJwheDesQmhizHIQgVSVjJDwkSCPzHEgZLRPoDF8IDwNX/9z9xvt/+asFif+0ATsYwwGCDXwVmvgYBh34Zebb6Ona9dNC1HLQY9XC1g3fbeZr6v3z0/iS+hsAegDF/x4CBAHTAv0EEAj9C5cRBhZWGykffCK0Ij4kcyCCHdoZrBIhDj4JRwO4AEb9Tvzn+nz7KwmJ+SoQIg5FAuwXBwZV+0wIhuvi6ajnFNUD2YfUidIH2njauuMN6lDuoPdd+Zv9SADH/uAAfACd/7QCWgTHBtgN1A8PF5YbJh5rIjoioiE7IAwb+xZfEqMLHQgkA8T/Nf+a+zD9DQoI+4cQ/A+zBPQXIgp4/VAIxO9t6WrnqtX21eDSGM/j1RfYuN6g5/br+/Qt+QD9fACg/24CfABJAUkDgAOyB5UMRA+xFoUabR7BIW4j0iE4Ib0cPxfXEnQMqAbaAqv+YvxO+8v7ngAjAzUE4BDCCrUN8xFnBA8F+/oW8Avpld5G2ZjUoM/O1SjVk9rw43rotPAO9t38+P9V/9UGGQLAAnwHIgPTB90LqQunE8IWPRm5HzgfPyFrIZccjRy7FWsPdA7YBDkCBgDR+v77UvrWAjf/qAbkDMkITQ7/C0EEGgLC983v2uYN3oPZc9Mr0k7V2tVC3KjiRelM78j1Z/of/+H/1QJ2BKwDRga8B64JhwxsEXQU0xj+G8AfKyGGIVQg5x75Gp8VsBLTCyoIJgMAAHn9uPo8AAT/jwDcCGoIaQnDC9IGggRO/bH1Ie5K5ULeLdkC1VnU0tW62Kjd2uL16cjvyfMy+l/9n/40AjQD+QQBBpcIsQsrDmkRbRaDGDAcMx6IHxwgDh7DG1IZTxRVECEMrwdRBGUB+f4J/lMDvgAQBaAIKQjdCmkH2QRSAS/5avIE7Ovi0t3g2BvWpdUO1r3Zp90z4jPnMu1Z8QP2q/no/OL/2QLsBDsI2QtODlMTbRYCGvwd0h8IIrQiASI3IcUdgRqbFrURYA2DCIEEkQGx/ZP/tP5W/tgC5QKCBA0FmQI8Ap78nPfc8kzr/uXr4OzcBts12hrbuN684fnleOur71f0PPhZ+pz+GgCMASAFpwZMCdIMWw+lE3UWZxmlHKEdTR8/H9gdDx20GfQWpRMmD00MZwjvBJUDrwKlANoBwwEBAp4CogEvAaP/0PuM+MH0Fe9r6gzmZeGA3u3bXdrQ2oDbP90L4JzjE+cC66/vdvM1+Kf81gCZBQEKeg7wEj8X8RpfHg8hBCNYJGgkvyM1Ij8goBx2GbwVeRGJDVMJewcjBJgBvgB+/zr+ZP0B/Nj67vh89trz7PCd7X/qg+ev5Kvi+OCv31zfe9/432zhDuNU5TPoTesW70fzm/em/OABDgdRDMsR1RZUG4QfISPxJdwn3Cg0KWgotiZPJCUhRB31GDEUVA+sCuIFrQHL/R76L/d39DXyYfDI7jztEOzZ6tTp3ej35zPnjOYC5qDldOWG5dvljeaS5/HozOoa7bTv3fJg9kP6Wf6sAgUHZwueD6UTYBeTGmUdfx8LIdIh9yFWIRAgER6UG4UYEhW9Ee8NQAq1BmgDVgCe/Q/73/gB9zr1vfNn8iLxEfAM7x3uS+2c7OXrbev/6tbq5Oot67rrpOzR7WTvSvF/8xH24fjh+xn/YAKzBQ8JQwxRDw8ShxSLFiQYQBnPGd8ZaBloGPAWFBXbEmAQ1g0gC4MI1QVYA/sA3v74/D77zflu+E33PfZR9XT0tPPw8j3yn/EJ8ZbwOvD/7/TvJfCN8D7xL/Jn89T0k/Z0+KH62vwy/5UB8QMxBmAIXgocDJsNxQ6cDysQWBBBEOQPOQ9TDmwNMwwFC9QJjwh3B1MGNQU0BCsDJAIhARsAB//s/b78ivsz+t74d/cY9rr0XfMl8vDwCvBA78numO677iTv6+8I8X7yTvRQ9sH4Tfv2/boAYwMIBmEInAp5DBUOQw8YEIMQhxBPEKsPMA/XDcoMgQsVCroIQwfhBVUE5wKBAQQA4/55/Vf8U/tK+kX5r/jR9073Gfeq9o/2xvbW9kz3kfci+Bf5fvmU+pr7fPxy/XL+Y/+yACMBaQIqA4MDdAS8BFUFMgUEBm4FSgaFBeIFtQUxBnYFDwbZBY8FEwX/BJkEfQOjAxsCpgGRAKv/zP6X/Zj8Jvz++lH6Y/k6+aX4Mfge+EP4SfiE+OT4cPlU+uL6BvwI/cv9ZP8LAD4BcAIpAywEJgXcBe8FEgdbBpQHkQYZB+4GIAZ1BwsGOwYwBucFkQXrBFMEzgOhAqQBzQDd/5v+mf1P/E37z/oc+ZH5wfcK+Kr3kfYC+Jf26fec96f43fh3+cz6VPvT/Dv9YP+I/+EBqwEVBCEEXAV0BmIGYwelB54HPQiUBzEIqQfGBxcJcQfnCDUIwAgMCFEH4Aa2BTYEXQLWAQj/h/01/Bn6qfgC94n1B/UW84byjPIY8dvxa/HG8SLztPIP9Sv2f/cA+qf7uP1nAA4CLQT/BssHBwqDCwIMfg3KDSYOLw5IDpMNKw2zDAsMPwxBC88KNQqTCAwIBgbqBH0D/ADY//r9lvtw+rf4Sfeg9bj0kPNH8mjxqvBl8BLw7O+M8K3wdfHv8t/zifVo9wz5ePs//dT/1gGgA4AGyQfLCTcL5gzZDUAOfg9gD1EPhA8SD2UOJA9KDeIMEgzLCskJkQcvBogELgJ6AHb+mPwJ+xb5CPh69uD0XPRm86vy9fGr8RrygfEt8pHytfO19Gv1Avfq+PX5CvyP/Sz/jQEPAo4EkQV6BoEIigiqCUQKNQraCn8KiwqUCpwJbwnqCXQIFQh4B9gGFwZNBHgDogI+ARAA4v4B/jP9jvs1+yH6qfnj+Of3xfcp9wr3oPar9rz2CPdo9873h/ib+Ub6Dfs6/Lv90v6o/yIBUAL1AgoEIQXtBTUG8gZOB3wHaAdRB8sGyQb/BVEF+gRHBHUDdAK3AQMBEAAv/7b+l/2Q/d38Vvy+/Pf7Nvxi/Bf8tvzA/EL9hf0E/gL+tv5E/xb/5v9IADsAsgCFAOUAIgHoAFYBagEwAVkBegErAV8BNQFyAQwBSQHwAPwAlQDDAJMAJQCJAOD/EgD4/53/mv9m/1z/UP9P/0j/Lf8a/3X/YP9H/3T/mf9t/9//if8gADUAAwCEAIQAVACNAI0AxQDXAFQAzwCOAGcAdAAkAFgAWwDg/ycA5P+4/9//o/9//3P/gv9+/2r/X/9T/3n/sv+C/6L/p/+t/7//1P/l/8v/GgAXAPv/GwBAAAsAUgAeADMAKwD//wQAMwAGAAgA8f8dAPn/xP/2//X/3v/s/wIAFQDU/yAAGQD6//n//f8tACwA/P82AAgATABFAPP/LwA5AA8ACQAFACsABwANAAEAGAAKAOX//f8YALv/DQDi/+r/4f+0/+P/x/+k/6T/z//w/9r/1f/A//r/1f/f/9D/BgACAB8A9/8OADcA9/8RAEUAEABTAEAAHgBqAPb/DgAcAOj/DQDa/xgA9f/e/w4A7v/c/xQA1v8QAPH/+f8XAAEAIwAXACUAWgAfAB4ARwBJAGIAWAB3AIMAYwBQAFYAWwBmAE0AVQBoACgAKQD2/+n/4//V/8X/yv+s/67/lv+O/1r/X/+B/4f/s/+W/7P/wv+x/8T/rP+7/wwA9f8YAPP/MgAYADAACgBAAD0AZwBGAEgAZgBAAEAAVgBaAD4AWgBTAGwAZgBaAGQAYABdACkAOABHACUA7f/0/+D/0f+h/5X/nP9t/4P/dv9l/2H/Qf9d/0z/dP9n/6f/qP/L/9b//f8JAAkAHABaAGAAjACCAJEAlACVAJEAaQBcAFgAIAAwABgABQDu/+3/5P/O/9T/0v/b/87/1P/G/8v/9//r/w0ALgBAAEcASQA7AFAAQwBFACsANwAgACYA+//y/9j/uf+//6b/lv+g/4b/tf+T/4j/jf+R/7j/l//E/87/2f/l/9z/6v/1/wYAFAAcAC8AUAA0AFgAYAB3AHsAeQCKAHUAcABqAFcAbwBXAD0APAAjACQABgDn/+f/3f/D/6X/sP+2/6T/qf+m/63/m/+V/5z/n//B/7n/3v/g//X/AgD2//7///8FACUAFwAqACgAOgBGADIALgA3AB0AFQAAAP7/+v/y////8f/k/+//5v/x/+H/0f/Z/9L/1P/E/93/6P/m//n/6//5//P/8v/z/wUABwAAAP7/DgAVABIAGAAiAC8ALgA4ACgAOgA6ADgAMgAqACoAIQAaABQAEAAQAPv/7v/g/9L/yf/E/7f/vv+z/7n/tv++/8f/wf/Q/9r/1f/o/+j/8/8JAAkAEwAiAC4AMwA3AD4ARQBJAEkARQA4AEEAOQAxADgALQAyACsAJAARABMADgAHAAcA+//3//7/8f/5//j/7v/w/+//5f/o/+r/4//s/+X/3//m/+H/3f/Y/9b/0f/Y/9r/0//b/9X/1f/T/+H/3P/e/+P/4//1//P/9f/3/wUABQASAA4AGwAaABwAJAAsACYAJAAhACEAHQAaABsAHQAZABkACwAJAAAABQD//wIA9//3/+3/9//s/+r/8P/w/+z/6f/w/+7/9f/6//b/+f/5/wEAAwABAAcABAAEAAAABwAHAAoABQAKAAAACQAGAAAAAwADAPv/9f/9//L/+//8//X/+f8AAPf/+/8AAPr///8EAP7//v8AAAAAAgAEAAAAAAD+/wIABgAJAAgAAgAAAAEAAQACAAAAAQADAP7/AQACAAIACQAAAAkAAwAJAAQABgAGAAcABQAFAAYAAQAAAP//+/8DAAAA///9//3/9f/0//P/9v/y/+3/6//r/+T/6v/q/+n/5P/m/+H/5//t/+X/6P/q//D/8v/3//j/9P/7//v/AAAHAAUABwAIABAAEgAQABYAGAAaABcAFQAaABMAEAAVABEAFgAMABAAEAALAA0ADwANAAsACgAJAAQAAQAEAAkABgAKAAcABAAIAAkADAARAA8AEQARABgAEAAXABcAGAAZABcAFwAVABYAGAAZABUAEQANAAYACwAFAAAA+v/1//L/7v/o/+P/5P/g/9//3P/U/9r/1f/W/9H/2f/S/9z/2P/h/+D/4v/k/+X/7f/s//r/9//4////BgAHAAcADwAUABIAHAAfACQAKAApACkALgAtACsAKgAnACkAKgAmAB8AIgAYABgAFwATABIADAAKAAAAAAD+//X/9f/s/+z/6v/i/+b/2v/h/97/2//f/9z/1v/f/9n/2//a/9//4P/j/+X/4//p/+z/8P/x//r/+P/8/wYAAgAJAAgADwAOABgAGQAZAB8AHgAeABwAJAAoACMAKAApACIAIQAlACMAIgAcABwAGgAaABsAGQAdABQAFwAUABgAGAAQABYAFQAQAA8ACwATAAkADwAMAAkACgADAAgA/v/+//3/+P/1//P/7P/u/+j/4v/f/+P/3f/a/97/2P/b/9z/3//c/9//3v/e/+b/5v/s/+z/7f/t//L/9f/4//X////6//7/AQAEAAAABQAAAAAABAD//wYAAQAHAAUABgAHAAcACgAQAAcAEQAPAAwAEQATAA8ADAAPAA4AEAANAA0ABQAIAAsAAAADAAIA/P/6//X/8v/t//P/7v/t/+n/6f/t/+b/7v/u/+//8//0//n/9//9/wAAAwAAAAYABQAMAA8AEQASABQAEwAWABIAFwAbABMAEgAQAA8ADAAHAAUAAgACAPz/+f/z//L/8P/r/+7/6//l/+X/5P/p/+z/8P/r//P/+f/0//7/+v8GAAgACQAMABAAEAAWABQAGQAYABkAGgAaABcAFgASABAAEAAPAAkAAwAHAAAAAAD7//X/9v/1//T/8f/u/+3/8v/w//L/9P/w//j/9f/7//j/+//8//3//f8BAAAABAAFAAIABwAIAAcADAAJAAQACQAGAAgACQADAAQAAAAAAAAA+v////n/9f/0//b/9f/2//L/8v/1//L/9//y//n/+f/7//v//v8BAAQAAQAJAAMABgALAA4ACQASAAwADAAMAAgACwALAAYACAAEAAAAAQAAAPz/+v/4//b/9f/0//L/8//v/+3/8v/v/+//7v/v//T/8P/y//P/9P/3//n/+v/7//3/AAABAP//AQADAAcABQAEAAcABwAKAAgADAALAA0ADgAOAA0ACgAMAA4ADAAIAAYADAAEAAcABAAHAAEA//8GAP7/AQD9/wMA+/8AAPv//v8AAAAA/v/9////AAD8/wAA/P/7//r/+v/6//f/+v/5//b/9//2//j/9v/2//P/9//0//n/9f/1//X/+P/1//b/+v/4//j/+//9//r//v8AAAMA//8FAAUAAQAHAAkADQAIAA0ADwALAA8AEQAQABMADwATABEAFAAVABYAEgAPABUADwATABEACwALAAcABgAEAAYABAD+//3//P/7//r//P/4//T/+P/1//P/8v/1//D/9f/w//H/8P/z//X/8//2//f/+P/5//r/+//8//v//f/+/wAAAQAAAP//AAD//wAAAAAAAAIAAAACAAAAAAABAAAA//8AAAAA/f/+//r//P/6//j/+P/8//v/9f/7//n/9//2//X/9f/z//H/8f/y/+z/" } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "402": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable", "insufficient-credit", "unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/contacts": { "get": { "tags": [ "contacts" ], "summary": "List contacts", "description": "Use `q`, `page`, and `limit` to build CRM selectors, outbound tools, or external sync jobs. `id` is always available; legacy contacts may return `uuid: null` until they are updated.\n\n## Before you start\n\nUse filters and the documented pagination fields to limit the result set.\n\n## Response\n\nRead contact IDs and external references for subsequent updates.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "contactsList", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/contacts/list-contacts/" }, "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "updated_since", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "include_deleted", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 500, "default": 100 } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "contacts": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "integer" }, "uuid": { "type": "string", "nullable": true }, "firstname": { "type": "string" }, "lastname": { "type": "string" }, "phone": { "type": "string" }, "email": { "type": "string" }, "address": { "type": "string" }, "zip": { "type": "string" }, "country": { "type": "string" }, "call_status": { "type": "string" }, "company": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "integer" }, "name": { "type": "string" } }, "required": [ "id", "name" ] }, "shared_users": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "integer" }, "name": { "type": "string" } }, "required": [ "id", "name" ] } }, "custom_fields": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "integer" }, "slug": { "type": "string" }, "value": { "type": "string" } }, "required": [ "id", "slug", "value" ] } }, "external": { "type": "object", "additionalProperties": false, "properties": { "source": { "type": "string" }, "id": { "type": "string" } }, "required": [ "source", "id" ] }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "deleted_at": { "type": "string", "nullable": true } }, "required": [ "id", "uuid", "firstname", "lastname", "phone", "email", "address", "zip", "country", "call_status", "company", "shared_users", "custom_fields", "external", "created_at", "updated_at", "deleted_at" ] } }, "pagination": { "type": "object", "additionalProperties": false, "properties": { "page": { "type": "integer" }, "per_page": { "type": "integer" }, "total": { "type": "integer" }, "total_pages": { "type": "integer" } }, "required": [ "page", "per_page", "total", "total_pages" ] } }, "required": [ "status", "contacts", "pagination" ] }, "example": { "status": "success", "contacts": [ { "id": 123, "uuid": "0c3a6f9e-3b2c-4c22-9c25-9b6f9c0b2a11", "firstname": "Alice", "lastname": "Example", "phone": "+442079460001", "email": "alice@example.test", "address": "", "zip": "", "country": "US", "call_status": "callback", "company": { "id": 88, "name": "Example Corp" }, "shared_users": [ { "id": 42, "name": "Alice Agent" } ], "custom_fields": [ { "id": 5, "slug": "crm_id", "value": "C-1001" } ], "external": { "source": "crm", "id": "contact_123" }, "created_at": "2026-01-15 12:00:00+00:00", "updated_at": "2026-01-15 12:00:00+00:00", "deleted_at": null } ], "pagination": { "page": 1, "per_page": 50, "total": 1, "total_pages": 1 } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } } }, "post": { "tags": [ "contacts" ], "summary": "Create or update contact", "description": "Recommended for syncing from external CRMs because it is idempotent when `external_source` and `external_id` are stable. Supports company, sharing, status, and dynamic custom field data. Send the complete custom-field values for create/update, using existing field IDs or slugs. Configured required extra fields must be supplied. Invalid or unknown fields return HTTP 422 without saving the contact; valid values are not rewritten. Number fields use a dot decimal without grouping separators, dates use YYYY-MM-DD, and URLs require http:// or https://.\n\n## Before you start\n\nProvide a name and an existing ID, UUID or external reference when updating.\n\n## Response\n\nInspect the returned contact identity and fields.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "contactsUpsert", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/contacts/create-or-update-contact/" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "external_source": { "type": "string" }, "external_id": { "type": "string" }, "name": { "type": "string" }, "phone": { "type": "string" }, "email": { "type": "string" }, "company_id": { "type": "integer" }, "shared_user_ids": { "type": "array", "items": { "type": "integer" } }, "call_status": { "type": "string" }, "custom_fields": { "type": "object", "additionalProperties": false, "properties": { "crm_id": { "type": "string" }, "source": { "type": "string" } }, "required": [ "crm_id", "source" ] }, "id": { "type": "integer" }, "uuid": { "type": "string" } }, "required": [ "name" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "contact": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "integer" }, "uuid": { "type": "string", "nullable": true }, "firstname": { "type": "string" }, "lastname": { "type": "string" }, "phone": { "type": "string" }, "email": { "type": "string" }, "address": { "type": "string" }, "zip": { "type": "string" }, "country": { "type": "string" }, "call_status": { "type": "string" }, "company": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "integer" }, "name": { "type": "string" } }, "required": [ "id", "name" ] }, "shared_users": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "integer" }, "name": { "type": "string" } }, "required": [ "id", "name" ] } }, "custom_fields": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "integer" }, "slug": { "type": "string" }, "value": { "type": "string" } }, "required": [ "id", "slug", "value" ] } }, "external": { "type": "object", "additionalProperties": false, "properties": { "source": { "type": "string" }, "id": { "type": "string" } }, "required": [ "source", "id" ] }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "deleted_at": { "type": "string", "nullable": true } }, "required": [ "id", "uuid", "firstname", "lastname", "phone", "email", "address", "zip", "country", "call_status", "company", "shared_users", "custom_fields", "external", "created_at", "updated_at", "deleted_at" ] } }, "required": [ "status", "contact" ] }, "example": { "status": "success", "contact": { "id": 123, "uuid": "0c3a6f9e-3b2c-4c22-9c25-9b6f9c0b2a11", "firstname": "Alice", "lastname": "Example", "phone": "+442079460001", "email": "alice@example.test", "address": "", "zip": "", "country": "US", "call_status": "callback", "company": { "id": 88, "name": "Example Corp" }, "shared_users": [], "custom_fields": [ { "id": 5, "slug": "crm_id", "value": "C-1001" } ], "external": { "source": "", "id": "" }, "created_at": "2026-01-15 12:00:00+00:00", "updated_at": "2026-01-15 12:00:00+00:00", "deleted_at": null } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/contacts/workspace": { "get": { "tags": [ "contacts" ], "summary": "Get contact workspace metadata", "description": "Use this once when bootstrapping external CRM sync or contact management tools.\n\n## Before you start\n\nRead workspace metadata before constructing a contact form or integration.\n\n## Response\n\nUse the available agents, companies, statuses and custom fields in contact updates.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "contactsWorkspace", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/contacts/get-contact-workspace-metadata/" }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "status_options": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "value": { "type": "string" }, "label": { "type": "string" } }, "required": [ "value", "label" ] } }, "shareable_users": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "integer" }, "name": { "type": "string" } }, "required": [ "id", "name" ] } }, "companies": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "website": { "type": "string" }, "phone": { "type": "string" }, "email": { "type": "string" }, "address": { "type": "string" }, "contacts_count": { "type": "integer" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "id", "name", "website", "phone", "email", "address", "contacts_count", "created_at", "updated_at" ] } }, "custom_field_definitions": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "integer" }, "slug": { "type": "string" }, "label": { "type": "string" }, "field_type": { "type": "string" }, "placeholder": { "type": "string" }, "help_text": { "type": "string" }, "sort_order": { "type": "integer" }, "is_required": { "type": "boolean" } }, "required": [ "id", "slug", "label", "field_type", "placeholder", "help_text", "sort_order", "is_required" ] } } }, "required": [ "status", "status_options", "shareable_users", "companies", "custom_field_definitions" ] }, "example": { "status": "success", "status_options": [ { "value": "new", "label": "New" }, { "value": "callback", "label": "Call Back" } ], "shareable_users": [ { "id": 1, "name": "Account Owner" }, { "id": 42, "name": "Alice Agent" } ], "companies": [ { "id": 88, "name": "Example Corp", "website": "https://example.test", "phone": "+442079460001", "email": "ops@example.test", "address": "Main Street 1", "contacts_count": 12, "created_at": "2026-01-15 12:00:00+00:00", "updated_at": "2026-01-15 12:00:00+00:00" } ], "custom_field_definitions": [ { "id": 5, "slug": "crm_id", "label": "CRM ID", "field_type": "text", "placeholder": "External ID", "help_text": "Reference from your CRM.", "sort_order": 40, "is_required": false } ] } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/contacts/companies": { "get": { "tags": [ "contacts" ], "summary": "List companies", "description": "Use this to resolve valid `company_id` values before contact upserts.\n\n## Before you start\n\nSearch by company name or the documented contact details.\n\n## Response\n\nUse the returned company ID when linking a contact.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "contactsCompaniesList", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/contacts/list-companies/" }, "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "companies": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "website": { "type": "string" }, "contacts_count": { "type": "integer" } }, "required": [ "id", "name", "website", "contacts_count" ] } } }, "required": [ "status", "companies" ] }, "example": { "status": "success", "companies": [ { "id": 88, "name": "Example Corp", "website": "https://example.test", "contacts_count": 12 } ] } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } } }, "post": { "tags": [ "contacts" ], "summary": "Create or update company", "description": "Only account owners can manage company records through the public API.\n\n## Before you start\n\nUse an account owner key. Include an existing ID when updating a company.\n\n## Response\n\nInspect the returned company ID and details.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "contactsCompaniesSave", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/contacts/create-or-update-company/" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "name": { "type": "string" }, "website": { "type": "string" }, "phone": { "type": "string" }, "email": { "type": "string" }, "address": { "type": "string" }, "id": { "type": "integer" } }, "required": [ "name" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "company": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "website": { "type": "string" }, "phone": { "type": "string" }, "email": { "type": "string" }, "address": { "type": "string" }, "contacts_count": { "type": "integer" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "id", "name", "website", "phone", "email", "address", "contacts_count", "created_at", "updated_at" ] } }, "required": [ "status", "company" ] }, "example": { "status": "success", "company": { "id": 88, "name": "Alice Example", "website": "https://example.test", "phone": "+442079460001", "email": "ops@example.test", "address": "Main Street 1", "contacts_count": 12, "created_at": "2026-01-15 12:00:00+00:00", "updated_at": "2026-01-15 12:00:00+00:00" } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/contacts/companies/archive": { "post": { "tags": [ "contacts" ], "summary": "Archive company", "description": "The contact company text remains on historical contacts, but `company_id` is cleared.\n\n## Before you start\n\nSelect the company you intend to archive and check its linked contacts.\n\n## Response\n\nInspect the archive status and company ID in the response.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "contactsCompaniesArchive", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/contacts/archive-company/" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "company_id": { "type": "integer" } }, "required": [ "company_id" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "archived": { "type": "boolean" }, "company": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "integer" } }, "required": [ "id" ] } }, "required": [ "status", "archived", "company" ] }, "example": { "status": "success", "archived": true, "company": { "id": 88 } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/contacts/delete": { "post": { "tags": [ "contacts" ], "summary": "Delete contact", "description": "Use UUID for direct deletes, or external IDs when you mirror CRM records.\n\n## Before you start\n\nIdentify the contact by UUID or the documented external-reference pair.\n\n## Response\n\nInspect the deletion result for the selected contact.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "contactsDelete", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/contacts/delete-contact/" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "uuid": { "type": "string" }, "external_source": { "type": "string" }, "external_id": { "type": "string" } } } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "deleted": { "type": "boolean" }, "contact": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "integer" }, "uuid": { "type": "string", "nullable": true }, "external": { "type": "object", "additionalProperties": false, "properties": { "source": { "type": "string" }, "id": { "type": "string" } }, "required": [ "source", "id" ] } }, "required": [ "id", "uuid", "external" ] } }, "required": [ "status", "deleted", "contact" ] }, "example": { "status": "success", "deleted": true, "contact": { "id": 123, "uuid": "0c3a6f9e-3b2c-4c22-9c25-9b6f9c0b2a11", "external": { "source": "crm", "id": "contact_123" } } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/calls": { "get": { "tags": [ "calls" ], "summary": "List calls", "description": "Use this for CDR reporting, reconciliation, and recording lookups. Results are unique by `call_id` and use bounded cursor pagination: follow `pagination.next_cursor` while `pagination.has_more` is true. `started_at` is ISO-8601 UTC and the deprecated `starttime` alias remains a naive UTC string for v1 compatibility.\n\n## Before you start\n\nChoose filters and a bounded page size for the call history you need.\n\n## Response\n\nUse pagination.next_cursor while pagination.has_more is true.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "callsList", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/calls/list-calls/" }, "parameters": [ { "name": "sip_user_id", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[A-Za-z0-9_.-]{1,64}$" } }, { "name": "days", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 31, "default": 7 } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 500, "default": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[A-Za-z0-9_-]+$" } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "calls", "pagination" ], "properties": { "status": { "type": "string", "enum": [ "success" ] }, "calls": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "call_id", "sip_user_id", "from", "to", "direction", "status", "number", "started_at", "starttime", "duration_seconds", "hangup_cause", "failure_reason_code", "failure_reason", "contact_id", "contact_name" ], "properties": { "call_id": { "type": "string", "pattern": "^CALL-[A-F0-9]{16}(?:[A-F0-9]{8})?$" }, "sip_user_id": { "type": "string", "nullable": true, "pattern": "^(?:\\+?[0-9]{3,32}|anonymous)$" }, "from": { "type": "string", "nullable": true, "pattern": "^(?:\\+?[0-9]{3,32}|anonymous)$" }, "to": { "type": "string", "nullable": true, "pattern": "^(?:\\+?[0-9]{3,32}|anonymous)$" }, "direction": { "type": "string", "enum": [ "incoming", "outgoing", "unknown" ] }, "status": { "type": "string", "enum": [ "completed", "failed" ] }, "number": { "type": "string", "nullable": true, "pattern": "^(?:\\+?[0-9]{3,32}|anonymous)$", "deprecated": true }, "started_at": { "type": "string", "format": "date-time", "nullable": true, "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$" }, "starttime": { "type": "string", "nullable": true, "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{2}:[0-9]{2}:[0-9]{2}$", "deprecated": true }, "duration_seconds": { "type": "integer", "minimum": 0 }, "hangup_cause": { "type": "string", "nullable": true, "pattern": "^(?:NORMAL_CLEARING|ANSWER|ANSWERED|BUSY|USER_BUSY|NO_ANSWER|CHANUNAVAIL|CONGESTION|CALL_REJECTED|CANCEL|FAILED|UNKNOWN|SIP_[1-6][0-9]{2}|Q850_(?:[1-9]|[1-9][0-9]|1[01][0-9]|12[0-7]))$" }, "failure_reason_code": { "type": "string", "nullable": true, "enum": [ "call_failed", "busy", "no_answer", "unavailable", "congestion", "call_rejected", "destination_not_callable", "fraud_control_blocked_country", "fraud_control_blocked_prefix", "fraud_control_max_rate", "insufficient_balance", "invalid_cli", "invalid_cli_selected", "callerid_invalid", "callerid_blocked", "unauthorized_cli", "callerid_policy", "policy_request_failed", "policy_prerequisite_failed", "policy_evaluation_failed", null ] }, "failure_reason": { "type": "string", "nullable": true, "maxLength": 180 }, "contact_id": { "type": "integer", "nullable": true, "minimum": 1 }, "contact_name": { "type": "string", "nullable": true, "maxLength": 160 } } } }, "pagination": { "type": "object", "additionalProperties": false, "required": [ "limit", "has_more", "next_cursor" ], "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 500 }, "has_more": { "type": "boolean" }, "next_cursor": { "type": "string", "nullable": true, "minLength": 1, "maxLength": 4096, "pattern": "^[A-Za-z0-9_-]+$" } } } } }, "example": { "status": "success", "calls": [ { "call_id": "CALL-111111111111111111111111", "sip_user_id": "900001", "from": "1051", "to": "+442079460001", "direction": "outgoing", "status": "completed", "number": "+442079460001", "started_at": "2026-01-15T12:00:00Z", "starttime": "2026-08-24 10:00:00", "duration_seconds": 45, "hangup_cause": "NORMAL_CLEARING", "failure_reason_code": null, "failure_reason": null, "contact_id": 8, "contact_name": "Customer" } ], "pagination": { "limit": 100, "has_more": false, "next_cursor": null } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } } } }, "/api/v1/voice/calls/active": { "get": { "tags": [ "voice" ], "summary": "List active calls", "description": "Use this to discover live call IDs. When a DID is routed to Voice API Control, ringing inbound calls appear here and can be answered through the Voice API answer endpoint.\n\n## Before you start\n\nUse this to find current calls available to your account.\n\n## Response\n\nUse call_id to identify a ringing call; answer only when can_answer_via_api is true.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "voiceCallsActive", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/voice/list-active-calls/" }, "parameters": [ { "name": "sip_user_id", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[A-Za-z0-9_.-]{1,64}$" } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "calls": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "call_id": { "type": "string" }, "call_control_id": { "type": "string", "nullable": true }, "sip_user_id": { "type": "string" }, "status": { "type": "string" }, "direction": { "type": "string" }, "from": { "type": "string" }, "to": { "type": "string" }, "voice_api_control": { "type": "boolean" }, "can_answer_via_api": { "type": "boolean" } }, "required": [ "call_id", "call_control_id", "sip_user_id", "status", "direction", "from", "to", "voice_api_control", "can_answer_via_api" ] } } }, "required": [ "status", "calls" ] }, "example": { "status": "success", "calls": [ { "call_id": "CALL-111111111111111111111111", "call_control_id": null, "sip_user_id": "900001", "status": "ringing", "direction": "inbound", "from": "+442079460001", "to": "+442079460001", "voice_api_control": true, "can_answer_via_api": true } ] } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } } } }, "/api/v1/voice/backend/status": { "get": { "tags": [ "voice" ], "summary": "Get Voice API status", "description": "Use this before placing calls from automation if you need a quick readiness check.\n\n## Before you start\n\nUse this endpoint to check Voice API availability before diagnosing your integration.\n\n## Response\n\nRead the public availability status and customer-facing message.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "voiceBackendStatus", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/voice/get-voice-api-status/" }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "backend_status": { "type": "string", "enum": [ "operational", "degraded", "unavailable" ] }, "message": { "type": "string" } }, "required": [ "status", "backend_status", "message" ] }, "example": { "status": "success", "backend_status": "operational", "message": "Voice backend is operational." } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/voice/call-control/calls": { "post": { "tags": [ "voice" ], "summary": "Create call", "description": "This is the main Voice API entry point. Create the call once, then use the returned `call_control_id` to control it with speech, gather, hold, transfer, DTMF, or chained actions. An `Idempotency-Key` header is required for safe retries.\n\n## Before you start\n\nChoose your SIP identity, destination and the documented caller-ID options. Provide an Idempotency-Key.\n\n## Response\n\nStore call_control_id and follow call progress; accepted does not mean answered.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`, `insufficient-credit`, `idempotency-conflict`.", "operationId": "voiceControlCreate", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/voice/create-call/" }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable", "insufficient-credit", "idempotency-conflict" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "sip_user_id": { "type": "string" }, "to": { "type": "string" }, "from": { "type": "string" }, "timeout_seconds": { "type": "integer" }, "record": { "type": "boolean" } }, "required": [ "to" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "call_control_id": { "type": "string", "nullable": false }, "sip_user_id": { "type": "string" }, "to": { "type": "string" }, "state": { "type": "string", "enum": [ "accepted", "failed" ] }, "reconciliation_pending": { "type": "boolean" } }, "required": [ "status", "call_control_id", "sip_user_id", "to", "state" ] }, "example": { "status": "success", "call_control_id": "vapi_111111111111111111111111", "sip_user_id": "900001", "to": "442079460001", "state": "accepted" } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "402": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } } } }, "/api/v1/voice/call-control/execute": { "post": { "tags": [ "voice" ], "summary": "Execute action chain", "description": "Use this for chained speak → gather → speak flows without round-tripping between each action. The response includes call_control_id, results and vars. Each result includes type, ok and the response fields of that action; an unsuccessful action includes error. Inspect the batch status and each result even after HTTP 200. Charge objects may be null when no charge applies. An Idempotency-Key header is required; reuse the same key only for an identical request. A selected text action may return voice_content_review_required with fields.review_reference. Open Communication reviews in your account to explain the activity. This stops later actions even when stop_on_error is false. Earlier completed actions remain completed; the rejected text action is not charged or played. Repeating the same key returns the same result, not another attempt.\n\n## Before you start\n\nBuild an ordered action list for an existing call-control session.\n\n## Response\n\nInspect every action result; do not assume all actions completed because the request was accepted.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`, `insufficient-credit`, `idempotency-conflict`.", "operationId": "voiceControlExecute", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/voice/execute-action-chain/" }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable", "insufficient-credit", "idempotency-conflict" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "call_control_id": { "type": "string", "nullable": false }, "vars": { "type": "object", "additionalProperties": {} }, "actions": { "type": "array", "items": { "type": "object", "required": [ "type" ], "additionalProperties": true, "properties": { "type": { "type": "string", "enum": [ "playback", "speak", "gather", "wait", "hold", "unhold", "dtmf", "status", "transfer", "hangup" ] }, "save_as": { "type": "string" }, "save_field": { "type": "string" } } } } }, "required": [ "call_control_id", "actions" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success", "error" ] }, "call_control_id": { "type": "string", "nullable": false }, "results": { "type": "array", "items": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "call_control_id": { "type": "string", "nullable": false }, "media": { "type": "string" }, "type": { "type": "string", "enum": [ "playback" ] }, "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "status", "call_control_id", "media", "type", "ok" ] }, { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "call_control_id": { "type": "string", "nullable": false }, "media": { "type": "string" }, "tts_charge": { "type": "object", "additionalProperties": false, "properties": { "transaction_id": { "type": "string", "nullable": true, "pattern": "^TX-[A-F0-9]{12,24}$" }, "product": { "type": "string" }, "characters": { "type": "integer" }, "rate_per_char_eur": { "type": "number" }, "amount_eur": { "type": "number" } }, "required": [ "transaction_id", "product", "characters", "rate_per_char_eur", "amount_eur" ], "nullable": true }, "type": { "type": "string", "enum": [ "speak" ] }, "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "status", "call_control_id", "media", "tts_charge", "type", "ok" ] }, { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "call_control_id": { "type": "string", "nullable": false }, "input": { "type": "string", "enum": [ "speech", "dtmf" ] }, "transcript": { "type": "string" }, "tts_charge": { "type": "object", "additionalProperties": false, "properties": { "transaction_id": { "type": "string", "nullable": true, "pattern": "^TX-[A-F0-9]{12,24}$" }, "product": { "type": "string" }, "characters": { "type": "integer" }, "rate_per_char_eur": { "type": "number" }, "amount_eur": { "type": "number" } }, "required": [ "transaction_id", "product", "characters", "rate_per_char_eur", "amount_eur" ], "nullable": true }, "stt_charge": { "type": "object", "additionalProperties": false, "properties": { "transaction_id": { "type": "string", "nullable": true, "pattern": "^TX-[A-F0-9]{12,24}$" }, "product": { "type": "string" }, "duration_seconds": { "type": "integer" }, "billed_minutes": { "type": "integer" }, "rate_per_min_eur": { "type": "number" }, "amount_eur": { "type": "number" } }, "required": [ "transaction_id", "product", "duration_seconds", "billed_minutes", "rate_per_min_eur", "amount_eur" ], "nullable": true }, "digits": { "type": "string" }, "type": { "type": "string", "enum": [ "gather" ] }, "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "status", "call_control_id", "input", "tts_charge", "type", "ok" ] }, { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "call_control_id": { "type": "string", "nullable": false }, "seconds": { "type": "integer" }, "type": { "type": "string", "enum": [ "wait" ] }, "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "status", "call_control_id", "seconds", "type", "ok" ] }, { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "call_control_id": { "type": "string", "nullable": false }, "music_class": { "type": "string", "nullable": true }, "type": { "type": "string", "enum": [ "hold" ] }, "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "status", "call_control_id", "music_class", "type", "ok" ] }, { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "call_control_id": { "type": "string", "nullable": false }, "type": { "type": "string", "enum": [ "unhold" ] }, "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "status", "call_control_id", "type", "ok" ] }, { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "call_control_id": { "type": "string", "nullable": false }, "digits": { "type": "string" }, "type": { "type": "string", "enum": [ "dtmf" ] }, "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "status", "call_control_id", "digits", "type", "ok" ] }, { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "call_control_id": { "type": "string", "nullable": false }, "state": { "type": "string" }, "call_status": { "type": "string" }, "terminal": { "type": "boolean" }, "to": { "type": "string" }, "from": { "type": "string" }, "created_at": { "type": "string", "format": "date-time", "nullable": true }, "answered_at": { "type": "string", "format": "date-time", "nullable": true }, "ended_at": { "type": "string", "format": "date-time", "nullable": true }, "failure_reason": { "type": "string", "nullable": true }, "type": { "type": "string", "enum": [ "status" ] }, "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "status", "call_control_id", "state", "call_status", "terminal", "to", "from", "created_at", "answered_at", "ended_at", "failure_reason", "type", "ok" ] }, { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "call_control_id": { "type": "string", "nullable": false }, "transfer_id": { "type": "string" }, "transfer": { "type": "object", "additionalProperties": false, "properties": { "state": { "type": "string" }, "message": { "type": "string" }, "target_type": { "type": "string" }, "target_value": { "type": "string" }, "can_cancel": { "type": "boolean" } }, "required": [ "state", "message", "target_type", "target_value", "can_cancel" ] }, "type": { "type": "string", "enum": [ "transfer" ] }, "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "status", "call_control_id", "transfer_id", "transfer", "type", "ok" ] }, { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "call_control_id": { "type": "string", "nullable": false }, "message": { "type": "string" }, "terminated_channels": { "type": "integer" }, "idempotent": { "type": "boolean" }, "type": { "type": "string", "enum": [ "hangup" ] }, "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "status", "call_control_id", "message", "terminated_channels", "type", "ok" ] }, { "type": "object", "additionalProperties": false, "required": [ "type", "ok", "error" ], "properties": { "type": { "type": "string", "enum": [ "playback", "speak", "gather", "wait", "hold", "unhold", "dtmf", "status", "transfer", "hangup" ] }, "ok": { "type": "boolean", "enum": [ false ] }, "error": { "type": "string" }, "error_code": { "type": "string" }, "fields": { "type": "object", "additionalProperties": false, "properties": { "review_reference": { "type": "string" } } } } } ] } }, "vars": { "oneOf": [ { "type": "object", "additionalProperties": {} }, { "type": "array", "maxItems": 0, "items": {} } ] }, "error": { "type": "string" }, "error_code": { "type": "string" }, "fields": { "type": "object", "additionalProperties": false, "properties": { "review_reference": { "type": "string" } } } }, "required": [ "status", "call_control_id", "results", "vars" ] }, "example": { "status": "success", "call_control_id": "vapi_111111111111111111111111", "results": [ { "type": "wait", "ok": true, "status": "success", "call_control_id": "vapi_111111111111111111111111", "seconds": 1 } ], "vars": {} } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "402": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } } } }, "/api/v1/voice/call-control/answer": { "post": { "tags": [ "voice" ], "summary": "Answer inbound Voice API call", "description": "Use the public `call_id` from a `call_ringing` webhook with `can_answer_via_api: true`, or from the active-calls endpoint. Answer while the call is still ringing. The response returns a `call_control_id` for subsequent Voice API actions. If a request times out, retry Answer with the same `call_id`; it reuses the existing session. A call that has ended cannot be answered.\n\n## Before you start\n\nUse the public call_id from a ringing event or active-call result while can_answer_via_api is true.\n\n## Response\n\nSave call_control_id for the following actions.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "voiceControlAnswer", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/voice/answer-inbound-voice-api-call/" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "call_id": { "type": "string" }, "timeout_seconds": { "type": "integer" } }, "required": [ "call_id" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "call_id": { "type": "string" }, "call_control_id": { "type": "string", "nullable": false }, "state": { "type": "string" } }, "required": [ "status", "call_id", "call_control_id", "state" ] }, "example": { "status": "success", "call_id": "CALL-111111111111111111111111", "call_control_id": "vapi_111111111111111111111111", "state": "active" } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "402": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/voice/call-control/playback": { "post": { "tags": [ "voice" ], "summary": "Play audio", "description": "Use this when you already host your prompt and do not need TTS. Remote audio is limited to 10 minutes. The response `media` value is an opaque, short-lived reference valid only for this call.\n\n## Before you start\n\nUse an active call-control ID and an accessible supported audio URL.\n\n## Response\n\nThe returned media reference is temporary and scoped to this call.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "voiceControlPlayback", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/voice/play-audio/" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "call_control_id": { "type": "string", "nullable": false }, "audio_url": { "type": "string" } }, "required": [ "call_control_id", "audio_url" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "call_control_id": { "type": "string", "nullable": false }, "media": { "type": "string" } }, "required": [ "status", "call_control_id", "media" ] }, "example": { "status": "success", "call_control_id": "vapi_111111111111111111111111", "media": "vcm2.OPAQUE_CALL_SCOPED_MEDIA_REFERENCE" } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "402": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/voice/call-control/speak": { "post": { "tags": [ "voice" ], "summary": "Speak text", "description": "Use this to read text into the call with the selected voice key. TTS usage is billed per submitted character and successful responses include `tts_charge` when a billable prompt is created. The response `media` value is an opaque, short-lived reference scoped to this call. Each charge includes a public `transaction_id` matching the ledger (null when no balance movement exists). An Idempotency-Key header is required. Reuse the same key while `voice_request_pending` is returned. Only `voice_request_closed` confirms the unsuccessful request is settled and a new request may use a new key. Use an exact current voice ID from the Voice API catalog. Omitting voice uses the current default. Deprecated tts_engine/engine values remain accepted for compatibility and use the current speech settings. Previously supported voice selections remain accepted and resolve to the corresponding current voice. Use the voice catalog for current identifiers. Unknown names and ambiguous voice_N ordinals are rejected. Language hints remain separate from voice selection. A selected text request may return HTTP 403 with voice_content_review_required and fields.review_reference. That request is not charged or played. Open Communication reviews in your account to explain the activity. Repeating its key returns the same refusal; approval does not automatically replay it. An existing media reference takes precedence over unused text.\n\n## Before you start\n\nUse an active call-control ID, text, a voice_api voice and an Idempotency-Key.\n\n## Response\n\nKeep the returned media reference and public tts_charge transaction reference.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`, `insufficient-credit`, `idempotency-conflict`.", "operationId": "voiceControlSpeak", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/voice/speak-text/" }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable", "insufficient-credit", "idempotency-conflict" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "call_control_id": { "type": "string", "nullable": false }, "text": { "type": "string", "maxLength": 2000 }, "language": { "type": "string" }, "voice": { "type": "string" }, "tts_engine": { "type": "string", "deprecated": true }, "engine": { "type": "string", "deprecated": true } }, "required": [ "call_control_id", "text" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "call_control_id": { "type": "string", "nullable": false }, "media": { "type": "string" }, "tts_charge": { "type": "object", "additionalProperties": false, "properties": { "transaction_id": { "type": "string", "nullable": true, "pattern": "^TX-[A-F0-9]{12,24}$" }, "product": { "type": "string" }, "characters": { "type": "integer" }, "rate_per_char_eur": { "type": "number" }, "amount_eur": { "type": "number" } }, "required": [ "transaction_id", "product", "characters", "rate_per_char_eur", "amount_eur" ], "nullable": true } }, "required": [ "status", "call_control_id", "media", "tts_charge" ] }, "example": { "status": "success", "call_control_id": "vapi_111111111111111111111111", "media": "vcm2.OPAQUE_CALL_SCOPED_MEDIA_REFERENCE", "tts_charge": { "transaction_id": "TX-1A2B3C4D5E6F", "product": "voice_api_tts", "characters": 44, "rate_per_char_eur": 5e-05, "amount_eur": 0.0022 } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "402": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } } } }, "/api/v1/voice/call-control/gather": { "post": { "tags": [ "voice" ], "summary": "Gather DTMF or speech", "description": "Use `input: speech` or `input: dtmf` to capture user input during the call. `prompt_text` is billed as TTS by character, and speech recognition is billed per started minute with `stt_charge` in the response. Idempotency-Key is required whenever prompt TTS or speech recognition is billable. It is optional when neither component is billable, but recommended for retries. Charge `transaction_id` values match your ledger; unused components may be null or omitted. Reuse the same key while `voice_request_pending` is returned; `voice_request_closed` permits a new request. Omit speech_language for automatic recognition-language detection; # ends recorded speech. Use an exact current voice ID from the Voice API catalog. Omitting voice uses the current default. Deprecated tts_engine/engine values remain accepted for compatibility and use the current speech settings. Previously supported voice selections remain accepted and resolve to the corresponding current voice. Use the voice catalog for current identifiers. Unknown names and ambiguous voice_N ordinals are rejected. Language hints remain separate from voice selection. A selected text prompt may return HTTP 403 with voice_content_review_required and fields.review_reference before charging, playback or input capture. Open Communication reviews in your account to explain the activity. Repeating its key returns the same refusal; approval does not replay it. Selection order is prompt_media, then prompt_text, then prompt audio URL; unused text is not assessed.\n\n## Before you start\n\nChoose speech or DTMF, the prompt and supported language options for the active call.\n\n## Response\n\nRead the captured value and any TTS/STT charges; a completed gather is different from a pending request.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`, `insufficient-credit`, `idempotency-conflict`.", "operationId": "voiceControlGather", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/voice/gather-dtmf-or-speech/" }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable", "insufficient-credit", "idempotency-conflict" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "call_control_id": { "type": "string", "nullable": false }, "input": { "type": "string" }, "prompt_text": { "type": "string", "maxLength": 2000 }, "voice": { "type": "string" }, "prompt_language": { "type": "string" }, "speech_language": { "type": "string" }, "timeout_ms": { "type": "integer" }, "tts_engine": { "type": "string", "deprecated": true }, "engine": { "type": "string", "deprecated": true } }, "required": [ "call_control_id", "input" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "call_control_id": { "type": "string", "nullable": false }, "input": { "type": "string", "enum": [ "speech", "dtmf" ] }, "transcript": { "type": "string" }, "tts_charge": { "type": "object", "additionalProperties": false, "properties": { "transaction_id": { "type": "string", "nullable": true, "pattern": "^TX-[A-F0-9]{12,24}$" }, "product": { "type": "string" }, "characters": { "type": "integer" }, "rate_per_char_eur": { "type": "number" }, "amount_eur": { "type": "number" } }, "required": [ "transaction_id", "product", "characters", "rate_per_char_eur", "amount_eur" ], "nullable": true }, "stt_charge": { "type": "object", "additionalProperties": false, "properties": { "transaction_id": { "type": "string", "nullable": true, "pattern": "^TX-[A-F0-9]{12,24}$" }, "product": { "type": "string" }, "duration_seconds": { "type": "integer" }, "billed_minutes": { "type": "integer" }, "rate_per_min_eur": { "type": "number" }, "amount_eur": { "type": "number" } }, "required": [ "transaction_id", "product", "duration_seconds", "billed_minutes", "rate_per_min_eur", "amount_eur" ], "nullable": true }, "digits": { "type": "string" } }, "required": [ "status", "call_control_id", "input", "tts_charge" ] }, "example": { "status": "success", "call_control_id": "vapi_111111111111111111111111", "input": "speech", "transcript": "This is the fixed demo caller response.", "tts_charge": { "transaction_id": "TX-1A2B3C4D5E6F", "product": "voice_api_tts", "characters": 24, "rate_per_char_eur": 5e-05, "amount_eur": 0.0012 }, "stt_charge": { "transaction_id": "TX-2B3C4D5E6F70", "product": "voice_api_stt", "duration_seconds": 14, "billed_minutes": 1, "rate_per_min_eur": 0.02, "amount_eur": 0.02 } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "402": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } } } }, "/api/v1/voice/call-control/status": { "post": { "tags": [ "voice" ], "summary": "Get call status", "description": "Use this when you poll session state from an external orchestrator.\n\n## Before you start\n\nUse the call_control_id returned by Create or Answer.\n\n## Response\n\nInspect call state before deciding the next action.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`, `answered`, `busy`, `no-answer`, `completed`, `failed`.", "operationId": "voiceControlStatus", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/voice/get-call-status/" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "call_control_id": { "type": "string", "nullable": false } }, "required": [ "call_control_id" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "call_control_id": { "type": "string", "nullable": false }, "state": { "type": "string" }, "call_status": { "type": "string" }, "terminal": { "type": "boolean" }, "to": { "type": "string" }, "from": { "type": "string" }, "created_at": { "type": "string", "format": "date-time", "nullable": true }, "answered_at": { "type": "string", "format": "date-time", "nullable": true }, "ended_at": { "type": "string", "format": "date-time", "nullable": true }, "failure_reason": { "type": "string", "nullable": true } }, "required": [ "status", "call_control_id", "state", "call_status", "terminal", "to", "from", "created_at", "answered_at", "ended_at", "failure_reason" ] }, "example": { "status": "success", "call_control_id": "vapi_111111111111111111111111", "state": "active", "call_status": "active", "terminal": false, "to": "+442079460001", "from": "+442079460001", "created_at": "2026-01-15 12:00:00+00:00", "answered_at": "2026-01-15 12:00:00+00:00", "ended_at": null, "failure_reason": null } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable", "answered", "busy", "no-answer", "completed", "failed" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/voice/call-control/wait": { "post": { "tags": [ "voice" ], "summary": "Wait", "description": "Useful inside action chains when you need timing control between prompts.\n\n## Before you start\n\nChoose the documented wait duration for an existing control session.\n\n## Response\n\nContinue according to the resulting call state.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "voiceControlWait", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/voice/wait/" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "call_control_id": { "type": "string", "nullable": false }, "seconds": { "type": "integer" } }, "required": [ "call_control_id", "seconds" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "call_control_id": { "type": "string", "nullable": false }, "seconds": { "type": "integer" } }, "required": [ "status", "call_control_id", "seconds" ] }, "example": { "status": "success", "call_control_id": "vapi_111111111111111111111111", "seconds": 1 } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/voice/call-control/transfer": { "post": { "tags": [ "voice" ], "summary": "Transfer call", "description": "Use this after a gather result or business-logic decision. The transfer runs asynchronously and should be tracked through the transfer-status endpoint.\n\n## Before you start\n\nChoose the supported destination for an active call and provide the required request fields.\n\n## Response\n\nTrack the transfer result rather than treating acceptance as a completed transfer.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`, `failed`.", "operationId": "voiceControlTransfer", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/voice/transfer-call/" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "call_control_id": { "type": "string", "nullable": false }, "target": { "type": "object", "additionalProperties": false, "properties": { "type": { "type": "string" }, "value": { "type": "string" } }, "required": [ "type", "value" ] }, "to": { "type": "string" } }, "required": [ "call_control_id" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "call_control_id": { "type": "string", "nullable": false }, "transfer_id": { "type": "string" }, "transfer": { "type": "object", "additionalProperties": false, "properties": { "state": { "type": "string" }, "message": { "type": "string" }, "target_type": { "type": "string" }, "target_value": { "type": "string" }, "can_cancel": { "type": "boolean" } }, "required": [ "state", "message", "target_type", "target_value", "can_cancel" ] } }, "required": [ "status", "call_control_id", "transfer_id", "transfer" ] }, "example": { "status": "success", "call_control_id": "vapi_111111111111111111111111", "transfer_id": "xfer_11111111111111111111111111111111", "transfer": { "state": "connecting", "message": "Connecting transfer destination…", "target_type": "pstn", "target_value": "+442079460001", "can_cancel": true } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "402": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable", "failed" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/voice/call-control/transfer-status": { "post": { "tags": [ "voice" ], "summary": "Get transfer status", "description": "Poll this endpoint after starting a transfer to know whether the destination is ringing, completed, failed, or canceled.\n\n## Before you start\n\nUse the identifiers returned when the transfer was requested.\n\n## Response\n\nRead progress, completion or failure before deciding on recovery.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`, `failed`.", "operationId": "voiceControlTransferStatus", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/voice/get-transfer-status/" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "transfer_id": { "type": "string" } }, "required": [ "transfer_id" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "transfer_id": { "type": "string" }, "call_control_id": { "type": "string", "nullable": false }, "transfer": { "type": "object", "additionalProperties": false, "properties": { "state": { "type": "string" }, "message": { "type": "string" }, "target_type": { "type": "string" }, "target_value": { "type": "string" }, "started_at": { "type": "string", "format": "date-time", "nullable": true }, "completed_at": { "type": "string", "format": "date-time", "nullable": true }, "failed_at": { "type": "string", "format": "date-time", "nullable": true }, "canceled_at": { "type": "string", "format": "date-time", "nullable": true }, "terminal": { "type": "boolean" }, "can_cancel": { "type": "boolean" }, "resume_original": { "type": "boolean" } }, "required": [ "state", "message", "target_type", "target_value", "started_at", "completed_at", "failed_at", "canceled_at", "terminal", "can_cancel", "resume_original" ] } }, "required": [ "status", "transfer_id", "call_control_id", "transfer" ] }, "example": { "status": "success", "transfer_id": "xfer_11111111111111111111111111111111", "call_control_id": "vapi_111111111111111111111111", "transfer": { "state": "ringing", "message": "Destination is ringing…", "target_type": "pstn", "target_value": "+33145512022", "started_at": "2026-01-15T12:00:00Z", "completed_at": null, "failed_at": null, "canceled_at": null, "terminal": false, "can_cancel": true, "resume_original": false } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable", "failed" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/voice/call-control/transfer-cancel": { "post": { "tags": [ "voice" ], "summary": "Cancel transfer", "description": "Use this while the transfer is still connecting or ringing.\n\n## Before you start\n\nInspect the transfer status and use the matching transfer identifiers.\n\n## Response\n\nRead the cancellation result and check the current call state.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "voiceControlTransferCancel", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/voice/cancel-transfer/" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "transfer_id": { "type": "string" } }, "required": [ "transfer_id" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "transfer_id": { "type": "string" }, "call_control_id": { "type": "string", "nullable": false }, "transfer": { "type": "object", "additionalProperties": false, "properties": { "state": { "type": "string" }, "message": { "type": "string" }, "target_type": { "type": "string" }, "target_value": { "type": "string" }, "started_at": { "type": "string", "format": "date-time", "nullable": true }, "completed_at": { "type": "string", "format": "date-time", "nullable": true }, "failed_at": { "type": "string", "format": "date-time", "nullable": true }, "canceled_at": { "type": "string", "format": "date-time", "nullable": true }, "terminal": { "type": "boolean" }, "can_cancel": { "type": "boolean" }, "resume_original": { "type": "boolean" } }, "required": [ "state", "message", "target_type", "target_value", "started_at", "completed_at", "failed_at", "canceled_at", "terminal", "can_cancel", "resume_original" ] } }, "required": [ "status", "transfer_id", "call_control_id", "transfer" ] }, "example": { "status": "success", "transfer_id": "xfer_11111111111111111111111111111111", "call_control_id": "vapi_111111111111111111111111", "transfer": { "state": "canceled", "message": "Transfer canceled.", "target_type": "pstn", "target_value": "+33145512022", "started_at": "2026-01-15T12:00:00Z", "completed_at": null, "failed_at": null, "canceled_at": "2026-01-15 12:00:00+00:00", "terminal": true, "can_cancel": false, "resume_original": true } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/voice/call-control/hold": { "post": { "tags": [ "voice" ], "summary": "Hold call", "description": "Pair this with transfer or external supervisor workflows.\n\n## Before you start\n\nUse the control ID for the call you intend to place on hold.\n\n## Response\n\nCheck the returned state; use Unhold to resume.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "voiceControlHold", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/voice/hold-call/" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "call_control_id": { "type": "string", "nullable": false } }, "required": [ "call_control_id" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "call_control_id": { "type": "string", "nullable": false }, "music_class": { "type": "string", "nullable": true } }, "required": [ "status", "call_control_id", "music_class" ] }, "example": { "status": "success", "call_control_id": "vapi_111111111111111111111111", "music_class": null } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/voice/call-control/unhold": { "post": { "tags": [ "voice" ], "summary": "Unhold call", "description": "Call this after a hold or attended transfer flow.\n\n## Before you start\n\nUse the control ID of the held call.\n\n## Response\n\nCheck that the call has resumed before issuing another media action.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "voiceControlUnhold", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/voice/unhold-call/" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "call_control_id": { "type": "string", "nullable": false } }, "required": [ "call_control_id" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "call_control_id": { "type": "string", "nullable": false } }, "required": [ "status", "call_control_id" ] }, "example": { "status": "success", "call_control_id": "vapi_111111111111111111111111" } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/voice/call-control/dtmf": { "post": { "tags": [ "voice" ], "summary": "Send DTMF", "description": "Useful for external IVRs after a programmable prompt or transfer.\n\n## Before you start\n\nUse an active control session and the documented digits/duration options.\n\n## Response\n\nRead whether the tones were accepted for that call.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "voiceControlDtmf", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/voice/send-dtmf/" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "call_control_id": { "type": "string", "nullable": false }, "digits": { "type": "string" }, "timeout_ms": { "type": "integer" }, "duration_ms": { "type": "integer" } }, "required": [ "call_control_id", "digits" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "call_control_id": { "type": "string", "nullable": false }, "digits": { "type": "string" } }, "required": [ "status", "call_control_id", "digits" ] }, "example": { "status": "success", "call_control_id": "vapi_111111111111111111111111", "digits": "1" } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/voice/call-control/hangup": { "post": { "tags": [ "voice" ], "summary": "End call", "description": "Use this as the final action in automated workflows.\n\n## Before you start\n\nConfirm the call_control_id identifies the call you intend to end.\n\n## Response\n\nRead the result and final call status.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "voiceControlHangup", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/voice/end-call/" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "call_control_id": { "type": "string", "nullable": false } }, "required": [ "call_control_id" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "call_control_id": { "type": "string", "nullable": false }, "message": { "type": "string" }, "terminated_channels": { "type": "integer" }, "idempotent": { "type": "boolean" } }, "required": [ "status", "call_control_id", "message", "terminated_channels" ] }, "example": { "status": "success", "call_control_id": "vapi_111111111111111111111111", "message": "Call terminated.", "terminated_channels": 1 } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/recordings/play": { "get": { "tags": [ "calls" ], "summary": "Play or download recording", "description": "Use method=play for playback or method=download for a file response. Sandbox provides a sample recording.\n\n## Before you start\n\nUse a call reference from your call history and the documented playback or download mode.\n\n## Response\n\nHandle audio, processing and unavailable responses as documented; a pending recording is not ready to play.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`, `processing`, `unavailable`.", "operationId": "recordingsPlay", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/calls/play-or-download-recording/" }, "parameters": [ { "name": "call_id", "in": "query", "required": true, "schema": { "type": "string", "pattern": "^CALL-[A-F0-9]{16}(?:[A-F0-9]{8})?$" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "play", "download" ], "default": "play" } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable", "processing", "unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "responses": { "200": { "content": { "audio/mpeg": { "schema": { "type": "string", "format": "binary" } } }, "description": "Successful response" }, "206": { "headers": { "Content-Range": { "schema": { "type": "string" } }, "Accept-Ranges": { "schema": { "type": "string", "enum": [ "bytes" ] } } }, "content": { "audio/mpeg": { "schema": { "type": "string", "format": "binary" } } }, "description": "Request could not be completed" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "402": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "416": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "headers": { "Content-Range": { "schema": { "type": "string", "pattern": "^bytes \\*/[0-9]+$" } }, "Accept-Ranges": { "schema": { "type": "string", "enum": [ "bytes" ] } } }, "description": "Request could not be completed" }, "425": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "headers": { "Retry-After": { "schema": { "type": "integer", "minimum": 1, "maximum": 60 } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } } } }, "/api/v1/lookup/number": { "get": { "tags": [ "lookup" ], "summary": "Look up phone number", "description": "Returns normalized phone-number metadata such as formatting, country, type, and carrier details when available. `valid_number_format` only reflects numbering-plan validity, not whether a subscriber is currently active.\n\n## Before you start\n\nProvide the complete international number, including its country code.\n\n## Response\n\nRead the normalized number, format validity and number type. Format validity does not prove a subscriber is active.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`, `unknown`, `unavailable`.", "operationId": "lookupNumber", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/lookup/look-up-phone-number/" }, "parameters": [ { "name": "number", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable", "unknown", "unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "lookup": { "type": "object", "additionalProperties": false, "properties": { "requested_number": { "type": "string" }, "normalized_number": { "type": "string" }, "original_number": { "type": "string" }, "number_type": { "type": "string" }, "location": { "type": "string" }, "region_code": { "type": "string" }, "country_code": { "type": "integer" }, "valid_number_format": { "type": "boolean" }, "formatted_international": { "type": "string" }, "formatted_national": { "type": "string" }, "formatted_e164": { "type": "string" }, "carrier": { "type": "string" }, "time_zones": { "type": "array", "items": { "type": "string" } } }, "required": [ "requested_number", "normalized_number", "original_number", "number_type", "location", "region_code", "country_code", "valid_number_format", "formatted_international", "formatted_national", "formatted_e164", "carrier", "time_zones" ] } }, "required": [ "status", "lookup" ] }, "example": { "status": "success", "lookup": { "requested_number": "+442079460001", "normalized_number": "+442079460001", "original_number": "+442079460001", "number_type": "Fixed Line", "location": "United Kingdom Demo", "region_code": "GB", "country_code": 44, "valid_number_format": true, "formatted_international": "+442079460001", "formatted_national": "442079460001", "formatted_e164": "+442079460001", "carrier": "Demo Network", "time_zones": [ "Europe/London" ] } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } } } }, "/api/v1/lookup/hlr": { "post": { "tags": [ "lookup" ], "summary": "Live HLR lookup", "description": "Read operator, porting and activity information for a phone number. Optional checks depend on the number type and country; inspect the returned status and cost_eur fields.\n\n## Before you start\n\nProvide a complete international number and choose the optional checks you need.\n\n## Response\n\nRead the returned status and cost_eur. Availability of extra activity or porting information depends on the number.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`, `unknown`, `ported`, `unavailable`, `insufficient-credit`.", "operationId": "lookupHlr", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/lookup/live-hlr-lookup/" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "number": { "type": "string" }, "include_ported_date": { "type": "boolean" }, "check_landline_activity": { "type": "boolean" }, "check_us_mobile_activity": { "type": "boolean" } }, "required": [ "number" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "lookup": { "type": "object", "additionalProperties": false, "properties": { "lookup_id": { "type": "string" }, "requested_number": { "type": "string" }, "detected_number": { "type": "string" }, "formatted_number": { "type": "string" }, "number_type": { "type": "string" }, "number_status": { "type": "string" }, "ported_number": { "type": "boolean" }, "ported_on": { "type": "string" }, "current_network": { "type": "object", "additionalProperties": false, "properties": { "name": { "type": "string" }, "country_name": { "type": "string" }, "country_prefix": { "type": "string" }, "mccmnc": { "type": "string" } }, "required": [ "name", "country_name", "country_prefix", "mccmnc" ] }, "original_network": { "type": "object", "additionalProperties": false, "properties": { "name": { "type": "string" }, "country_name": { "type": "string" }, "country_prefix": { "type": "string" }, "mccmnc": { "type": "string" } }, "required": [ "name", "country_name", "country_prefix", "mccmnc" ] } }, "required": [ "lookup_id", "requested_number", "detected_number", "formatted_number", "number_type", "number_status", "ported_number", "ported_on", "current_network", "original_network" ] }, "cost_eur": { "type": "number" }, "result_source": { "type": "string" }, "result_fetched_at": { "type": "string" }, "replayed": { "type": "boolean" } }, "required": [ "status", "lookup", "cost_eur", "result_source", "result_fetched_at", "replayed" ] }, "example": { "status": "success", "lookup": { "lookup_id": "HLR-91A7B4C26D03", "requested_number": "+442079460001", "detected_number": "442079460001", "formatted_number": "+442079460001", "number_type": "Mobile", "number_status": "active", "ported_number": false, "ported_on": "", "current_network": { "name": "Demo Mobile Network", "country_name": "United Kingdom", "country_prefix": "44", "mccmnc": "00101" }, "original_network": { "name": "Demo Mobile Network", "country_name": "United Kingdom", "country_prefix": "44", "mccmnc": "00101" } }, "cost_eur": 0.02, "result_source": "live", "result_fetched_at": "2026-01-15 12:00:00+00:00", "replayed": false } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "402": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable", "unknown", "ported", "unavailable", "insufficient-credit" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/rates/countries": { "get": { "tags": [ "pricing" ], "summary": "List priced countries", "description": "Only routed destinations are returned. Use this for pricing pickers and cached catalogs.\n\n## Before you start\n\nUse your account API key to see destinations available to your account.\n\n## Response\n\nChoose a country before narrowing your rate search.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "ratesCountries", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/pricing/list-priced-countries/" }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "package_name": { "type": "string" }, "countries": { "type": "array", "items": { "type": "string" } } }, "required": [ "status", "package_name", "countries" ] }, "example": { "status": "success", "package_name": "Sandbox demo rates", "countries": [ "United Kingdom", "Canada", "Albania" ] } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/rates/search": { "get": { "tags": [ "pricing" ], "summary": "Search rates by prefix", "description": "Use this when you need an exact selling rate for a prefix before placing a call.\n\n## Before you start\n\nProvide a country or prefix filter to narrow the results.\n\n## Response\n\nRead the matching destination and rate; use a full-number quote before dialing.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "ratesSearch", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/pricing/search-rates-by-prefix/" }, "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "country", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 500, "default": 100 } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "package_name": { "type": "string" }, "rows": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "prefix": { "type": "string" }, "destination": { "type": "string" }, "enabled": { "type": "boolean" }, "rate_per_minute": { "type": "string" }, "billing": { "type": "object", "additionalProperties": false, "properties": { "init_seconds": { "type": "integer" }, "increment_seconds": { "type": "integer" } }, "required": [ "init_seconds", "increment_seconds" ] } }, "required": [ "prefix", "destination", "enabled", "rate_per_minute", "billing" ] } }, "has_more": { "type": "boolean" }, "next_offset": { "type": "integer", "nullable": true, "minimum": 0 } }, "required": [ "status", "package_name", "rows", "has_more", "next_offset" ] }, "example": { "status": "success", "package_name": "Sandbox demo rates", "rows": [ { "prefix": "44", "destination": "United Kingdom · Demo rate", "enabled": true, "rate_per_minute": "0.0400", "billing": { "init_seconds": 1, "increment_seconds": 1 } }, { "prefix": "1", "destination": "Canada · Demo rate", "enabled": true, "rate_per_minute": "0.0400", "billing": { "init_seconds": 1, "increment_seconds": 1 } }, { "prefix": "355", "destination": "Albania · Demo rate", "enabled": true, "rate_per_minute": "0.0400", "billing": { "init_seconds": 1, "increment_seconds": 1 } } ], "has_more": false, "next_offset": 3 } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } } } }, "/api/v1/rates/quote": { "get": { "tags": [ "pricing" ], "summary": "Quick quote", "description": "Use this before dialing if you need a precise quote from the current package and routing config. The response also includes the same final lookup metadata used by the standalone lookup endpoint when it is available.\n\n## Before you start\n\nProvide the complete destination number and the documented account options.\n\n## Response\n\nRead the returned price for the destination and inspect any restrictions.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "ratesQuote", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/pricing/quick-quote/" }, "parameters": [ { "name": "number", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "package_name": { "type": "string" }, "lookup": { "type": "object", "additionalProperties": false, "properties": { "requested_number": { "type": "string" }, "normalized_number": { "type": "string" }, "original_number": { "type": "string" }, "number_type": { "type": "string" }, "location": { "type": "string" }, "region_code": { "type": "string" }, "country_code": { "type": "integer" }, "valid_number_format": { "type": "boolean" }, "formatted_international": { "type": "string" }, "formatted_national": { "type": "string" }, "formatted_e164": { "type": "string" }, "carrier": { "type": "string" }, "time_zones": { "type": "array", "items": { "type": "string" } } }, "required": [ "requested_number", "normalized_number", "original_number", "number_type", "location", "region_code", "country_code", "valid_number_format", "formatted_international", "formatted_national", "formatted_e164", "carrier", "time_zones" ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "number": { "type": "string" }, "prefix": { "type": "string" }, "destination": { "type": "string" }, "enabled": { "type": "boolean" }, "rate_per_minute": { "type": "string" }, "billing": { "type": "object", "additionalProperties": false, "properties": { "init_seconds": { "type": "integer" }, "increment_seconds": { "type": "integer" } }, "required": [ "init_seconds", "increment_seconds" ] } }, "required": [ "number", "prefix", "destination", "enabled", "rate_per_minute", "billing" ] } }, "required": [ "status", "package_name", "lookup", "quote" ] }, "example": { "status": "success", "package_name": "Sandbox demo rates", "lookup": { "requested_number": "+442079460001", "normalized_number": "+442079460001", "original_number": "+442079460001", "number_type": "Fixed Line", "location": "United Kingdom Demo", "region_code": "GB", "country_code": 44, "valid_number_format": true, "formatted_international": "+442079460001", "formatted_national": "442079460001", "formatted_e164": "+442079460001", "carrier": "Demo Network", "time_zones": [ "Europe/London" ] }, "quote": { "number": "+442079460001", "prefix": "44", "destination": "United Kingdom · Demo rate", "enabled": true, "rate_per_minute": "0.0400", "billing": { "init_seconds": 1, "increment_seconds": 1 } } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } } } }, "/api/v1/sip/identities": { "get": { "tags": [ "sip" ], "summary": "List SIP identities", "description": "Each identity includes the connection mode and the actions your application can use. `ip_address` is present only for an IP-authenticated identity.\n\n## Before you start\n\nUse the account API key from a trusted server.\n\n## Response\n\nSelect an identity and use available_actions to choose its supported setup flow.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "sipIdentities", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/sip/list-sip-identities/" }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "identities": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "sip_user_id": { "type": "string" }, "display_name": { "type": "string" }, "is_main": { "type": "boolean" }, "purpose": { "type": "string", "enum": [ "primary", "agent", "sip_line", "unknown" ] }, "auth_mode": { "type": "string", "enum": [ "password", "ip", "disabled", "unknown" ] }, "available_actions": { "type": "array", "uniqueItems": true, "items": { "type": "string", "enum": [ "password_bootstrap", "browser_token" ] } }, "ip_address": { "type": "string", "nullable": true } }, "required": [ "sip_user_id", "display_name", "is_main", "purpose", "auth_mode", "available_actions" ] } }, "main_sip_user_id": { "type": "string", "nullable": true } }, "required": [ "status", "identities", "main_sip_user_id" ] }, "example": { "status": "success", "identities": [ { "sip_user_id": "900001", "display_name": "Main account", "is_main": true, "purpose": "primary", "auth_mode": "password", "available_actions": [ "password_bootstrap", "browser_token" ] } ], "main_sip_user_id": "900001" } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/sip/bootstrap": { "get": { "tags": [ "sip" ], "summary": "Get SIP bootstrap data", "description": "Use this from a trusted backend to bootstrap a webphone, mobile client, or external SIP endpoint. The returned SIP password is scoped to the current account API key: rotating or disabling that key revokes this credential without changing the independently managed SIP-line password. Inactive, archived, IP-auth, conflicted, and policy-ineligible identities are rejected.\n\n## Before you start\n\nSelect an identity you own and a supported setup mode.\n\n## Response\n\nInspect the connection configuration and supported authentication mode. Device registration requires Production credentials.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "sipBootstrap", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/sip/get-sip-bootstrap-data/" }, "parameters": [ { "name": "sip_user_id", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[A-Za-z0-9_.-]{1,64}$" } }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "hostname", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "active_sip_user_id": { "type": "string" }, "credentials": { "type": "object", "additionalProperties": false, "properties": { "sip_user_id": { "type": "string" }, "display_name": { "type": "string" }, "caller_id": { "type": "string", "nullable": true }, "sip_password": { "type": "string" } }, "required": [ "sip_user_id", "display_name", "caller_id", "sip_password" ] }, "sip_users": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "sip_user_id": { "type": "string" }, "display_name": { "type": "string" }, "is_main": { "type": "boolean" } }, "required": [ "sip_user_id", "display_name", "is_main" ] } }, "selected_pop": { "type": "object", "additionalProperties": false, "properties": { "region_code": { "type": "string" }, "hostname": { "type": "string" } }, "required": [ "region_code", "hostname" ] }, "available_pops": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "region_code": { "type": "string" }, "hostname": { "type": "string" }, "secure_hostname": { "type": "string" } }, "required": [ "region_code", "hostname", "secure_hostname" ] } }, "browser_webrtc": { "type": "object", "additionalProperties": false, "properties": { "sip_domain": { "type": "string" }, "ws_server": { "type": "string" }, "transport": { "type": "string" }, "webrtc": { "type": "boolean" }, "auth_mode": { "type": "string" }, "token_header_name": { "type": "string" }, "transport_keepalive_seconds": { "type": "integer" }, "transport_keepalive_debounce_seconds": { "type": "integer" }, "options_ping_interval_seconds": { "type": "integer" }, "ice_servers": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "urls": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "username": { "type": "string" }, "credential": { "type": "string" } }, "required": [ "urls" ] } }, "turn_username": { "type": "string" }, "turn_credential": { "type": "string" }, "turn_expires_at": { "type": "string" }, "region_code": { "type": "string" }, "media_mode": { "type": "string" }, "media_encryption": { "type": "string" }, "srtp_keying": { "type": "string" }, "dtls_required": { "type": "boolean" }, "rtcp_mux_required": { "type": "boolean" } }, "required": [ "sip_domain", "ws_server", "transport", "webrtc", "auth_mode", "token_header_name", "transport_keepalive_seconds", "transport_keepalive_debounce_seconds", "options_ping_interval_seconds", "ice_servers", "turn_username", "turn_credential", "turn_expires_at", "region_code", "media_mode", "media_encryption", "srtp_keying", "dtls_required", "rtcp_mux_required" ] }, "config": { "type": "object", "additionalProperties": false, "properties": { "sip_domain": { "type": "string" }, "sip_proxy": { "type": "string" }, "ws_server": { "type": "string" }, "sips": { "type": "boolean" } }, "required": [ "sip_domain", "sip_proxy", "ws_server", "sips" ] }, "secure_native": { "type": "object", "additionalProperties": false, "properties": { "sip_domain": { "type": "string" }, "sip_proxy": { "type": "string" }, "transport": { "type": "string" }, "realm": { "type": "string" }, "region_code": { "type": "string" }, "registration_contact_param": { "type": "string" }, "registration_contact_value": { "type": "string" }, "registration_contact_uri_parameter": { "type": "string" }, "supported_media_modes": { "type": "array", "items": { "type": "string" } }, "media_mode": { "type": "string" }, "media_encryption": { "type": "string" }, "srtp_keying": { "type": "string" }, "dtls_required": { "type": "boolean" }, "rtcp_mux_required": { "type": "boolean" } }, "required": [ "sip_domain", "sip_proxy", "transport", "realm", "region_code", "registration_contact_param", "registration_contact_value", "registration_contact_uri_parameter", "supported_media_modes", "media_mode", "media_encryption", "srtp_keying", "dtls_required", "rtcp_mux_required" ] } }, "required": [ "status", "active_sip_user_id", "credentials", "sip_users", "selected_pop", "available_pops", "browser_webrtc", "config", "secure_native" ] }, "example": { "status": "success", "active_sip_user_id": "900001", "credentials": { "sip_user_id": "900001", "display_name": "Main account", "caller_id": "+442079460001", "sip_password": "DEMO-CANNOT-REGISTER" }, "sip_users": [ { "sip_user_id": "900001", "display_name": "Main account", "is_main": true } ], "selected_pop": { "region_code": "de", "hostname": "sandbox.invalid" }, "available_pops": [ { "region_code": "de", "hostname": "sandbox.invalid", "secure_hostname": "sandbox.invalid" } ], "browser_webrtc": { "sip_domain": "sandbox.invalid", "ws_server": "wss://sandbox.invalid", "transport": "wss", "webrtc": true, "auth_mode": "sip_password", "token_header_name": "X-Illy-Browser-Token", "transport_keepalive_seconds": 0, "transport_keepalive_debounce_seconds": 0, "options_ping_interval_seconds": 15, "ice_servers": [ { "urls": [ "turn:sandbox.invalid:3478" ], "username": "demo-unusable", "credential": "demo-unusable" } ], "turn_username": "demo-unusable", "turn_credential": "demo-unusable", "turn_expires_at": "2026-01-15 12:00:00+00:00", "region_code": "de", "media_mode": "dtls", "media_encryption": "dtls-srtp", "srtp_keying": "dtls-srtp", "dtls_required": true, "rtcp_mux_required": true }, "config": { "sip_domain": "sandbox.invalid", "sip_proxy": "sip:sandbox.invalid:5060", "ws_server": "wss://sandbox.invalid", "sips": false }, "secure_native": { "sip_domain": "sandbox.invalid", "sip_proxy": "sips:sandbox.invalid:5061", "transport": "tls", "realm": "sandbox.invalid", "region_code": "de", "registration_contact_param": "x-illy-media-mode", "registration_contact_value": "sdes", "registration_contact_uri_parameter": "x-illy-media-mode=sdes", "supported_media_modes": [ "plain", "sdes", "dtls" ], "media_mode": "sdes", "media_encryption": "sdes-srtp", "srtp_keying": "sdes-srtp", "dtls_required": false, "rtcp_mux_required": false } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } } } }, "/api/v1/sip/browser-token": { "post": { "tags": [ "sip" ], "summary": "Create browser token", "description": "Call this from your backend only using the account API key. Return the token payload to your frontend SDK instead of exposing the API key in browser code. The requested identity’s `available_actions` must include `browser_token`.\n\n## Before you start\n\nCreate this request on your server with the account API key and a permitted SIP identity.\n\n## Response\n\nReturn the short-lived token to your browser client, not the account API key.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "sipBrowserToken", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/sip/create-browser-token/" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "sip_user_id": { "type": "string" }, "region": { "type": "string" }, "hostname": { "type": "string" } } } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "token": { "type": "string" }, "expires_at": { "type": "string" }, "expires_in": { "type": "integer" }, "refresh_before_seconds": { "type": "integer" }, "header_name": { "type": "string" } }, "required": [ "status", "token", "expires_at", "expires_in", "refresh_before_seconds", "header_name" ] }, "example": { "status": "success", "token": "ivsb_browser_demo_invalid", "expires_at": "2026-01-15 12:00:00+00:00", "expires_in": 900, "refresh_before_seconds": 120, "header_name": "X-Illy-Browser-Token" } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "413": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/sip/browser-bootstrap": { "get": { "tags": [ "sip" ], "summary": "Get browser bootstrap from token", "description": "This is the managed SDK bootstrap endpoint. Send `Authorization: Bearer ` from your frontend after your backend has minted the token.\n\n## Before you start\n\nUse the short-lived Bearer token created by your server. This endpoint does not use X-Api-Key.\n\n## Response\n\nInspect the browser connection configuration. Browser registration and audio calls are available in Production.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "sipBrowserBootstrap", "security": [ { "sipBrowserTokenAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/sip/get-browser-bootstrap-from-token/" }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "active_sip_user_id": { "type": "string" }, "credentials": { "type": "object", "additionalProperties": false, "properties": { "sip_user_id": { "type": "string" }, "display_name": { "type": "string" }, "caller_id": { "type": "string", "nullable": true } }, "required": [ "sip_user_id", "display_name", "caller_id" ] }, "sip_users": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "sip_user_id": { "type": "string" }, "display_name": { "type": "string" }, "is_main": { "type": "boolean" } }, "required": [ "sip_user_id", "display_name", "is_main" ] } }, "selected_pop": { "type": "object", "additionalProperties": false, "properties": { "region_code": { "type": "string" }, "hostname": { "type": "string" } }, "required": [ "region_code", "hostname" ] }, "available_pops": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "region_code": { "type": "string" }, "hostname": { "type": "string" }, "secure_hostname": { "type": "string" } }, "required": [ "region_code", "hostname", "secure_hostname" ] } }, "browser_webrtc": { "type": "object", "additionalProperties": false, "properties": { "sip_domain": { "type": "string" }, "ws_server": { "type": "string" }, "transport": { "type": "string" }, "webrtc": { "type": "boolean" }, "auth_mode": { "type": "string" }, "token_header_name": { "type": "string" }, "transport_keepalive_seconds": { "type": "integer" }, "transport_keepalive_debounce_seconds": { "type": "integer" }, "options_ping_interval_seconds": { "type": "integer" }, "ice_servers": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "urls": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "username": { "type": "string" }, "credential": { "type": "string" } }, "required": [ "urls" ] } }, "turn_username": { "type": "string" }, "turn_credential": { "type": "string" }, "turn_expires_at": { "type": "string" }, "region_code": { "type": "string" }, "media_mode": { "type": "string" }, "media_encryption": { "type": "string" }, "srtp_keying": { "type": "string" }, "dtls_required": { "type": "boolean" }, "rtcp_mux_required": { "type": "boolean" } }, "required": [ "sip_domain", "ws_server", "transport", "webrtc", "auth_mode", "token_header_name", "transport_keepalive_seconds", "transport_keepalive_debounce_seconds", "options_ping_interval_seconds", "ice_servers", "turn_username", "turn_credential", "turn_expires_at", "region_code", "media_mode", "media_encryption", "srtp_keying", "dtls_required", "rtcp_mux_required" ] }, "auth": { "type": "object", "additionalProperties": false, "properties": { "mode": { "type": "string" }, "expires_at": { "type": "string" } }, "required": [ "mode", "expires_at" ] }, "browser_auth": { "type": "object", "additionalProperties": false, "properties": { "mode": { "type": "string" }, "header_name": { "type": "string" }, "scope": { "type": "string" }, "expires_at": { "type": "string" } }, "required": [ "mode", "header_name", "scope", "expires_at" ] } }, "required": [ "status", "active_sip_user_id", "credentials", "sip_users", "selected_pop", "available_pops", "browser_webrtc", "auth", "browser_auth" ] }, "example": { "status": "success", "active_sip_user_id": "900001", "credentials": { "sip_user_id": "900001", "display_name": "Main account", "caller_id": "+442079460001" }, "sip_users": [ { "sip_user_id": "900001", "display_name": "Main account", "is_main": true } ], "selected_pop": { "region_code": "de", "hostname": "sandbox.invalid" }, "available_pops": [ { "region_code": "de", "hostname": "sandbox.invalid", "secure_hostname": "sandbox.invalid" } ], "browser_webrtc": { "sip_domain": "sandbox.invalid", "ws_server": "wss://sandbox.invalid", "transport": "wss", "webrtc": true, "auth_mode": "browser_token", "token_header_name": "X-Illy-Browser-Token", "transport_keepalive_seconds": 0, "transport_keepalive_debounce_seconds": 0, "options_ping_interval_seconds": 15, "ice_servers": [ { "urls": [ "turn:sandbox.invalid:3478" ], "username": "demo-unusable", "credential": "demo-unusable" } ], "turn_username": "demo-unusable", "turn_credential": "demo-unusable", "turn_expires_at": "2026-01-15 12:00:00+00:00", "region_code": "de", "media_mode": "dtls", "media_encryption": "dtls-srtp", "srtp_keying": "dtls-srtp", "dtls_required": true, "rtcp_mux_required": true }, "auth": { "mode": "browser_token", "expires_at": "2026-01-15 12:00:00+00:00" }, "browser_auth": { "mode": "token", "header_name": "X-Illy-Browser-Token", "scope": "sip_browser_session", "expires_at": "2026-01-15 12:00:00+00:00" } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/dids/catalog/countries": { "get": { "tags": [ "dids" ], "summary": "List DID countries", "description": "Start with `include_number_types=true` to choose a country and then one of its returned number types. Existing integrations may continue to request one explicit `number_type`. Use region and number-search responses for purchasable fees.\n\n## Before you start\n\nChoose a country and inspect its available number types.\n\n## Response\n\nContinue with the country and type returned by the catalog.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "didCountries", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/phone-numbers/list-did-countries/" }, "parameters": [ { "name": "include_number_types", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "number_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "data": { "type": "object", "additionalProperties": false, "properties": { "number_types": { "type": "array", "items": { "type": "string" } }, "countries": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "country_iso": { "type": "string" }, "country_name": { "type": "string" }, "number_type": { "type": "string" }, "number_types": { "type": "array", "items": { "type": "string" } }, "number_type_meta": { "type": "object", "additionalProperties": { "type": "object", "additionalProperties": false, "properties": { "manual_required": { "type": "boolean" }, "stock_status": { "type": "string" }, "available_quantity": { "type": "integer", "nullable": true } }, "required": [ "manual_required", "stock_status", "available_quantity" ] } }, "manual_required": { "type": "boolean" } }, "required": [ "country_iso", "country_name", "number_type", "number_types", "number_type_meta", "manual_required" ] } } }, "required": [ "number_types", "countries" ] }, "meta": { "type": "object", "additionalProperties": false, "properties": { "count": { "type": "integer" } }, "required": [ "count" ] } }, "required": [ "status", "data", "meta" ] }, "example": { "status": "success", "data": { "number_types": [ "local" ], "countries": [ { "country_iso": "GB", "country_name": "United Kingdom", "number_type": "local", "number_types": [ "local" ], "number_type_meta": { "local": { "manual_required": false, "stock_status": "available", "available_quantity": 4 } }, "manual_required": false }, { "country_iso": "CA", "country_name": "Canada", "number_type": "local", "number_types": [ "local" ], "number_type_meta": { "local": { "manual_required": false, "stock_status": "available", "available_quantity": 2 } }, "manual_required": false }, { "country_iso": "AL", "country_name": "Albania", "number_type": "local", "number_types": [ "local" ], "number_type_meta": { "local": { "manual_required": true, "stock_status": "unknown", "available_quantity": null } }, "manual_required": true } ] }, "meta": { "count": 3 } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } } } }, "/api/v1/dids/catalog/regions": { "get": { "tags": [ "dids" ], "summary": "List DID regions", "description": "Call this after choosing a country to narrow the number search. Use the returned `region_code` value exactly as-is in the number search API. Some destinations use numeric region codes.\n\n## Before you start\n\nUse a catalog country and, where required, a number type.\n\n## Response\n\nChoose the region or category that fits the number you want.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "didRegions", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/phone-numbers/list-did-regions/" }, "parameters": [ { "name": "country_iso", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "number_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "data": { "type": "object", "additionalProperties": false, "properties": { "country_iso": { "type": "string" }, "number_type": { "type": "string" }, "regions": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "country_iso": { "type": "string" }, "region_code": { "type": "string" }, "region_name": { "type": "string" }, "number_type": { "type": "string" }, "pricing": { "type": "object", "additionalProperties": false, "properties": { "setup_fee": { "type": "integer" }, "monthly_fee": { "type": "integer" }, "per_minute_fee": { "type": "number" }, "connection_fee": { "type": "number", "nullable": true }, "currency": { "type": "string" }, "available_quantity": { "type": "integer" } }, "required": [ "setup_fee", "monthly_fee", "per_minute_fee", "connection_fee", "currency", "available_quantity" ] }, "regulation": { "type": "object", "additionalProperties": false, "properties": { "requires_documents": { "type": "boolean" }, "documents_required": { "type": "boolean" }, "address_required": { "type": "boolean" }, "identity_required": { "type": "boolean" }, "document_labels": { "type": "array", "items": { "type": "string" } }, "restrictions": { "type": "string", "nullable": true } }, "required": [ "requires_documents", "documents_required", "address_required", "identity_required", "document_labels", "restrictions" ] } }, "required": [ "country_iso", "region_code", "region_name", "number_type", "pricing", "regulation" ] } } }, "required": [ "country_iso", "number_type", "regions" ] }, "meta": { "type": "object", "additionalProperties": false, "properties": { "count": { "type": "integer" } }, "required": [ "count" ] } }, "required": [ "status", "data", "meta" ] }, "example": { "status": "success", "data": { "country_iso": "GB", "number_type": "local", "regions": [ { "country_iso": "GB", "region_code": "20", "region_name": "London demo", "number_type": "local", "pricing": { "setup_fee": 1, "monthly_fee": 2, "per_minute_fee": 0.01, "connection_fee": 0, "currency": "EUR", "available_quantity": 4 }, "regulation": { "documents_required": false, "address_required": false, "identity_required": false, "document_labels": [], "requires_documents": false, "restrictions": null } } ] }, "meta": { "count": 1 } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } } } }, "/api/v1/dids/numbers": { "get": { "tags": [ "dids" ], "summary": "Search DID numbers", "description": "Use this right before order creation to present live inventory. `regulation.address_scope` identifies local or national address restrictions when applicable. For request-only destinations, the response has `order_mode: quantity`, `manual_review_required: true` and a `products` list instead of selectable numbers. Use `limit` and `offset` to page through products; `meta.total_products` gives the matching total and `meta.next_offset` is null on the last page. Availability can change between requests. Select a returned product reference, obtain a quote, then submit the quantity and required documents/address. A successful request waits for staff review; it does not mean the number is active. `region_code` is optional: only send it when `/api/v1/dids/catalog/regions` returned a region for the selected country. Some destinations use numeric region codes such as `249`. If the country has no regional split, omit `region_code` entirely, for example `/api/v1/dids/numbers?country_iso=BE&number_type=local&limit=10`.\n\n## Before you start\n\nProvide a supported country/region and search options.\n\n## Response\n\nChoose an available number, then obtain a fresh order quote.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`, `unavailable`.", "operationId": "didNumbers", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/phone-numbers/search-did-numbers/" }, "parameters": [ { "name": "country_iso", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "region_code", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 500, "default": 100 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable", "unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "responses": { "200": { "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "data": { "type": "object", "additionalProperties": false, "properties": { "country_iso": { "type": "string" }, "region_code": { "type": "string" }, "number_type": { "type": "string" }, "pricing": { "type": "object", "additionalProperties": false, "properties": { "setup_fee": { "type": "integer" }, "monthly_fee": { "type": "integer" }, "per_minute_fee": { "type": "number" }, "connection_fee": { "type": "number", "nullable": true }, "currency": { "type": "string" } }, "required": [ "setup_fee", "monthly_fee", "per_minute_fee", "connection_fee", "currency" ] }, "regulation": { "type": "object", "additionalProperties": false, "properties": { "documents_required": { "type": "boolean" }, "address_required": { "type": "boolean" }, "identity_required": { "type": "boolean" }, "document_labels": { "type": "array", "items": { "type": "string" } }, "address_scope": { "type": "string", "nullable": true } }, "required": [ "documents_required", "address_required", "identity_required", "document_labels", "address_scope" ] }, "availability": { "type": "object", "additionalProperties": false, "properties": { "estimated_quantity": { "type": "integer" } }, "required": [ "estimated_quantity" ] }, "numbers": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "number": { "type": "string" }, "product_reference": { "type": "string" }, "country_iso": { "type": "string" }, "region_code": { "type": "string" } }, "required": [ "number", "product_reference", "country_iso", "region_code" ] } } }, "required": [ "country_iso", "region_code", "number_type", "pricing", "regulation", "availability", "numbers" ] }, "meta": { "type": "object", "additionalProperties": false, "properties": { "count": { "type": "integer" } }, "required": [ "count" ] } }, "required": [ "status", "data", "meta" ] }, { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "data": { "type": "object", "additionalProperties": false, "properties": { "country_iso": { "type": "string" }, "region_code": { "type": "string", "nullable": true }, "number_type": { "type": "string" }, "pricing": { "type": "object", "additionalProperties": false, "properties": { "setup_fee": { "type": "integer" }, "monthly_fee": { "type": "integer" }, "per_minute_fee": { "type": "number" }, "connection_fee": { "type": "number", "nullable": true }, "currency": { "type": "string" } }, "required": [ "setup_fee", "monthly_fee", "per_minute_fee", "connection_fee", "currency" ] }, "regulation": { "type": "object", "additionalProperties": false, "properties": { "documents_required": { "type": "boolean" }, "address_required": { "type": "boolean" }, "identity_required": { "type": "boolean" }, "document_labels": { "type": "array", "items": { "type": "string" } }, "address_scope": { "type": "string", "nullable": true } }, "required": [ "documents_required", "address_required", "identity_required", "document_labels", "address_scope" ] }, "availability": { "type": "object", "additionalProperties": false, "properties": { "estimated_quantity": { "type": "integer" } }, "required": [ "estimated_quantity" ] }, "numbers": { "type": "array", "items": {} }, "order_mode": { "type": "string" }, "manual_review_required": { "type": "boolean" }, "products": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "product_reference": { "type": "string" }, "country_iso": { "type": "string" }, "region_code": { "type": "string", "nullable": true }, "number_type": { "type": "string" }, "pricing": { "type": "object", "additionalProperties": false, "properties": { "setup_fee": { "type": "integer" }, "monthly_fee": { "type": "integer" }, "per_minute_fee": { "type": "number" }, "connection_fee": { "type": "number", "nullable": true }, "currency": { "type": "string" } }, "required": [ "setup_fee", "monthly_fee", "per_minute_fee", "connection_fee", "currency" ] }, "regulation": { "type": "object", "additionalProperties": false, "properties": { "documents_required": { "type": "boolean" }, "address_required": { "type": "boolean" }, "identity_required": { "type": "boolean" }, "document_labels": { "type": "array", "items": { "type": "string" } }, "address_scope": { "type": "string", "nullable": true } }, "required": [ "documents_required", "address_required", "identity_required", "document_labels", "address_scope" ] }, "order_mode": { "type": "string" }, "manual_review_required": { "type": "boolean" } }, "required": [ "product_reference", "country_iso", "region_code", "number_type", "pricing", "regulation", "order_mode", "manual_review_required" ] } } }, "required": [ "country_iso", "region_code", "number_type", "pricing", "regulation", "availability", "numbers", "order_mode", "manual_review_required", "products" ] }, "meta": { "type": "object", "additionalProperties": false, "properties": { "count": { "type": "integer" }, "product_count": { "type": "integer" }, "total_products": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" }, "next_offset": { "type": "integer", "nullable": true, "minimum": 0 } }, "required": [ "count", "product_count", "total_products", "limit", "offset", "next_offset" ] } }, "required": [ "status", "data", "meta" ] } ] }, "example": { "status": "success", "data": { "country_iso": "GB", "region_code": "20", "number_type": "local", "pricing": { "setup_fee": 1, "monthly_fee": 2, "per_minute_fee": 0.01, "connection_fee": 0, "currency": "EUR" }, "regulation": { "documents_required": false, "address_required": false, "identity_required": false, "document_labels": [], "address_scope": null }, "availability": { "estimated_quantity": 4 }, "numbers": [ { "number": "+442079460001", "product_reference": "didpr_demo_gb_local", "country_iso": "GB", "region_code": "20" }, { "number": "+442079460002", "product_reference": "didpr_demo_gb_local", "country_iso": "GB", "region_code": "20" }, { "number": "+442079460003", "product_reference": "didpr_demo_gb_local", "country_iso": "GB", "region_code": "20" }, { "number": "+442079460004", "product_reference": "didpr_demo_gb_local", "country_iso": "GB", "region_code": "20" } ] }, "meta": { "count": 4 } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } } } }, "/api/v1/dids/orders/config": { "get": { "tags": [ "dids" ], "summary": "Get DID routing config", "description": "Use this to show whether a DID points to a SIP line, queue, PSTN, or external URI.\n\n## Before you start\n\nUse the ID of a number order belonging to your account.\n\n## Response\n\nRead its current routing choices before editing.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "didOrdersConfigGet", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/phone-numbers/get-did-routing-config/" }, "parameters": [ { "name": "order_id", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "data": { "type": "object", "additionalProperties": false, "properties": { "order": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "integer" }, "number": { "type": "string" }, "status": { "type": "string" } }, "required": [ "id", "number", "status" ] }, "routing": { "type": "object", "additionalProperties": false, "properties": { "type": { "type": "string" }, "enabled": { "type": "boolean" }, "targets": { "type": "object", "additionalProperties": false, "properties": { "sip_user_id": { "type": "string" } }, "required": [ "sip_user_id" ] }, "destination_region": { "type": "string" } }, "required": [ "type", "enabled", "targets", "destination_region" ] }, "options": { "type": "object", "additionalProperties": false, "properties": { "sip_lines": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "sip_user_id": { "type": "string" }, "display_name": { "type": "string" }, "is_main": { "type": "boolean" } }, "required": [ "sip_user_id", "display_name", "is_main" ] } }, "queues": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "queue_id": { "type": "integer" }, "name": { "type": "string" } }, "required": [ "queue_id", "name" ] } } }, "required": [ "sip_lines", "queues" ] }, "supported_types": { "type": "array", "items": { "type": "string" } }, "supported_regions": { "type": "array", "items": { "type": "string" } } }, "required": [ "order", "routing", "options", "supported_types", "supported_regions" ] } }, "required": [ "status", "data" ] }, "example": { "status": "success", "data": { "order": { "id": 91001, "number": "+442079460001", "status": "active" }, "routing": { "type": "sip_line", "enabled": true, "targets": { "sip_user_id": "900001" }, "destination_region": "de" }, "options": { "sip_lines": [ { "sip_user_id": "900001", "display_name": "Demo line", "is_main": true } ], "queues": [ { "queue_id": 7, "name": "Demo sales" } ] }, "supported_types": [ "sip_line", "queue", "pstn", "sip_uri", "external_sip_server" ], "supported_regions": [ "de", "us", "sg" ] } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } } }, "post": { "tags": [ "dids" ], "summary": "Save DID routing config", "description": "Supports local SIP users, queues, PSTN forwarding, external SIP servers, and SIP URIs.\n\n## Before you start\n\nLoad the current configuration and prepare the intended routing change.\n\n## Response\n\nInspect the returned configuration and order state.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "didOrdersConfigSave", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/phone-numbers/save-did-routing-config/" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "order_id": { "type": "integer" }, "routing": { "type": "object", "additionalProperties": false, "required": [ "type" ], "properties": { "type": { "type": "string", "enum": [ "sip_line", "queue", "pstn", "sip_uri", "external_sip_server" ] }, "sip_user_id": { "type": "string" }, "queue_id": { "type": "integer", "minimum": 1 }, "phone_number": { "type": "string" }, "sip_uri": { "type": "string" }, "external_sip_server": { "type": "string" }, "external_address": { "type": "string" }, "destination_region": { "type": "string", "enum": [ "de", "us", "sg" ] } } } }, "required": [ "order_id" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "saved": { "type": "boolean" }, "message": { "type": "string" } }, "required": [ "status", "saved", "message" ] }, "example": { "status": "success", "saved": true, "message": "Configuration saved successfully." } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "402": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/dids/orders": { "get": { "tags": [ "dids" ], "summary": "List DID orders", "description": "Use this to reconcile provisioning, KYC state, and routing changes.\n\n## Before you start\n\nUse the documented filters to find your number orders.\n\n## Response\n\nRead order state and requirements before changing routing or submitting documents.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`, `completed`, `pending-documents`, `rejected`.", "operationId": "didOrdersList", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/phone-numbers/list-did-orders/" }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "totals": { "type": "object", "additionalProperties": false, "properties": { "active": { "type": "integer" }, "monthly_active": { "type": "integer" } }, "required": [ "active", "monthly_active" ] }, "orders": { "type": "object", "additionalProperties": false, "properties": { "active": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "order_id": { "type": "integer" }, "id": { "type": "integer" }, "order_label": { "type": "string" }, "number": { "type": "string" }, "status": { "type": "object", "additionalProperties": false, "properties": { "code": { "type": "string" }, "label": { "type": "string" } }, "required": [ "code", "label" ] }, "destination": { "type": "object", "additionalProperties": false, "properties": { "country": { "type": "string" }, "region": { "type": "string" } }, "required": [ "country", "region" ] }, "fees": { "type": "object", "additionalProperties": false, "properties": { "monthly": { "type": "integer" }, "per_minute": { "type": "number" }, "connection_fee": { "type": "number", "nullable": true }, "renewal_date": { "type": "string" } }, "required": [ "monthly", "per_minute", "connection_fee", "renewal_date" ] }, "created_at": { "type": "string" }, "regulation": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string" }, "requires_action": { "type": "boolean" }, "rejected": { "type": "boolean" }, "can_resubmit": { "type": "boolean" }, "documents_required": { "type": "boolean" }, "address_required": { "type": "boolean" }, "identity_required": { "type": "boolean" }, "document_labels": { "type": "array", "items": { "type": "string" } }, "rejection_reasons": { "type": "array", "items": { "type": "string" } }, "message": { "type": "string" } }, "required": [ "status", "requires_action", "rejected", "can_resubmit", "documents_required", "address_required", "identity_required", "document_labels", "rejection_reasons", "message" ] } }, "required": [ "order_id", "id", "order_label", "number", "status", "destination", "fees", "created_at", "regulation" ] } }, "pending": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "order_id": { "type": "integer" }, "id": { "type": "integer" }, "order_label": { "type": "string" }, "number": { "type": "string" }, "status": { "type": "object", "additionalProperties": false, "properties": { "code": { "type": "string" }, "label": { "type": "string" } }, "required": [ "code", "label" ] }, "destination": { "type": "object", "additionalProperties": false, "properties": { "country": { "type": "string" }, "region": { "type": "string" } }, "required": [ "country", "region" ] }, "fees": { "type": "object", "additionalProperties": false, "properties": { "monthly": { "type": "integer" }, "per_minute": { "type": "number" }, "connection_fee": { "type": "number", "nullable": true }, "renewal_date": { "type": "string", "nullable": true } }, "required": [ "monthly", "per_minute", "connection_fee", "renewal_date" ] }, "created_at": { "type": "string" }, "regulation": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string" }, "requires_action": { "type": "boolean" }, "rejected": { "type": "boolean" }, "can_resubmit": { "type": "boolean" }, "documents_required": { "type": "boolean" }, "address_required": { "type": "boolean" }, "identity_required": { "type": "boolean" }, "document_labels": { "type": "array", "items": { "type": "string" } }, "rejection_reasons": { "type": "array", "items": { "type": "string" } }, "message": { "type": "string" } }, "required": [ "status", "requires_action", "rejected", "can_resubmit", "documents_required", "address_required", "identity_required", "document_labels", "rejection_reasons", "message" ] } }, "required": [ "order_id", "id", "order_label", "number", "status", "destination", "fees", "created_at", "regulation" ] } }, "cancelled": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "order_id": { "type": "integer" }, "id": { "type": "integer" }, "order_label": { "type": "string" }, "number": { "type": "string" }, "status": { "type": "object", "additionalProperties": false, "properties": { "code": { "type": "string" }, "label": { "type": "string" } }, "required": [ "code", "label" ] }, "destination": { "type": "object", "additionalProperties": false, "properties": { "country": { "type": "string" }, "region": { "type": "string" } }, "required": [ "country", "region" ] }, "fees": { "type": "object", "additionalProperties": false, "properties": { "monthly": { "type": "integer" }, "per_minute": { "type": "number" }, "connection_fee": { "type": "number", "nullable": true }, "renewal_date": { "type": "string", "nullable": true } }, "required": [ "monthly", "per_minute", "connection_fee", "renewal_date" ] }, "created_at": { "type": "string" }, "regulation": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string" }, "requires_action": { "type": "boolean" }, "rejected": { "type": "boolean" }, "can_resubmit": { "type": "boolean" }, "documents_required": { "type": "boolean" }, "address_required": { "type": "boolean" }, "identity_required": { "type": "boolean" }, "document_labels": { "type": "array", "items": { "type": "string" } }, "rejection_reasons": { "type": "array", "items": { "type": "string" } }, "message": { "type": "string" } }, "required": [ "status", "requires_action", "rejected", "can_resubmit", "documents_required", "address_required", "identity_required", "document_labels", "rejection_reasons", "message" ] } }, "required": [ "order_id", "id", "order_label", "number", "status", "destination", "fees", "created_at", "regulation" ] } }, "rejected": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "order_id": { "type": "integer" }, "id": { "type": "integer" }, "order_label": { "type": "string" }, "number": { "type": "string" }, "status": { "type": "object", "additionalProperties": false, "properties": { "code": { "type": "string" }, "label": { "type": "string" } }, "required": [ "code", "label" ] }, "destination": { "type": "object", "additionalProperties": false, "properties": { "country": { "type": "string" }, "region": { "type": "string" } }, "required": [ "country", "region" ] }, "fees": { "type": "object", "additionalProperties": false, "properties": { "monthly": { "type": "integer" }, "per_minute": { "type": "number" }, "connection_fee": { "type": "number", "nullable": true }, "renewal_date": { "type": "string", "nullable": true } }, "required": [ "monthly", "per_minute", "connection_fee", "renewal_date" ] }, "created_at": { "type": "string" }, "regulation": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string" }, "requires_action": { "type": "boolean" }, "rejected": { "type": "boolean" }, "can_resubmit": { "type": "boolean" }, "documents_required": { "type": "boolean" }, "address_required": { "type": "boolean" }, "identity_required": { "type": "boolean" }, "document_labels": { "type": "array", "items": { "type": "string" } }, "rejection_reasons": { "type": "array", "items": { "type": "string" } }, "message": { "type": "string" } }, "required": [ "status", "requires_action", "rejected", "can_resubmit", "documents_required", "address_required", "identity_required", "document_labels", "rejection_reasons", "message" ] } }, "required": [ "order_id", "id", "order_label", "number", "status", "destination", "fees", "created_at", "regulation" ] } } }, "required": [ "active", "pending", "cancelled", "rejected" ] } }, "required": [ "status", "totals", "orders" ] }, "example": { "status": "success", "totals": { "active": 2, "monthly_active": 4 }, "orders": { "active": [ { "order_id": 91001, "id": 91001, "order_label": "DID-91001", "number": "+442079460001", "status": { "code": "active", "label": "Active" }, "destination": { "country": "United Kingdom", "region": "London demo" }, "fees": { "monthly": 2, "per_minute": 0.01, "connection_fee": 0, "renewal_date": "2026-02-15" }, "created_at": "2026-01-15 12:00:00+00:00", "regulation": { "status": "verified", "requires_action": false, "rejected": false, "can_resubmit": false, "documents_required": false, "address_required": false, "identity_required": false, "document_labels": [], "rejection_reasons": [], "message": "Regulatory verification is complete." } }, { "order_id": 92001, "id": 92001, "order_label": "DID-92001", "number": "+16135550101", "status": { "code": "active", "label": "Active" }, "destination": { "country": "Canada", "region": "Ottawa demo" }, "fees": { "monthly": 2, "per_minute": 0.01, "connection_fee": 0, "renewal_date": "2026-02-15" }, "created_at": "2026-01-15 12:00:00+00:00", "regulation": { "status": "verified", "requires_action": false, "rejected": false, "can_resubmit": false, "documents_required": false, "address_required": false, "identity_required": false, "document_labels": [], "rejection_reasons": [], "message": "Regulatory verification is complete." } } ], "pending": [ { "order_id": 91002, "id": 91002, "order_label": "DID-91002", "number": "+442079460002", "status": { "code": "pending", "label": "Pending" }, "destination": { "country": "United Kingdom", "region": "London demo" }, "fees": { "monthly": 2, "per_minute": 0.01, "connection_fee": 0, "renewal_date": null }, "created_at": "2026-01-15 12:00:00+00:00", "regulation": { "status": "verified", "requires_action": false, "rejected": false, "can_resubmit": false, "documents_required": false, "address_required": false, "identity_required": false, "document_labels": [], "rejection_reasons": [], "message": "Regulatory verification is complete." } }, { "order_id": 92002, "id": 92002, "order_label": "DID-92002", "number": "+16135550102", "status": { "code": "pending", "label": "Pending" }, "destination": { "country": "Canada", "region": "Ottawa demo" }, "fees": { "monthly": 2, "per_minute": 0.01, "connection_fee": 0, "renewal_date": null }, "created_at": "2026-01-15 12:00:00+00:00", "regulation": { "status": "verified", "requires_action": false, "rejected": false, "can_resubmit": false, "documents_required": false, "address_required": false, "identity_required": false, "document_labels": [], "rejection_reasons": [], "message": "Regulatory verification is complete." } }, { "order_id": 93001, "id": 93001, "order_label": "DID-93001", "number": "to be issued", "status": { "code": "pending", "label": "Pending" }, "destination": { "country": "Albania", "region": "National demo" }, "fees": { "monthly": 2, "per_minute": 0.01, "connection_fee": 0, "renewal_date": null }, "created_at": "2026-01-15 12:00:00+00:00", "regulation": { "status": "pending", "requires_action": true, "rejected": false, "can_resubmit": true, "documents_required": true, "address_required": true, "identity_required": false, "document_labels": [ "Proof of address" ], "rejection_reasons": [], "message": "Provide the required information." } } ], "cancelled": [ { "order_id": 91004, "id": 91004, "order_label": "DID-91004", "number": "+442079460004", "status": { "code": "cancelled", "label": "Cancelled" }, "destination": { "country": "United Kingdom", "region": "London demo" }, "fees": { "monthly": 2, "per_minute": 0.01, "connection_fee": 0, "renewal_date": null }, "created_at": "2026-01-15 12:00:00+00:00", "regulation": { "status": "verified", "requires_action": false, "rejected": false, "can_resubmit": false, "documents_required": false, "address_required": false, "identity_required": false, "document_labels": [], "rejection_reasons": [], "message": "Regulatory verification is complete." } } ], "rejected": [ { "order_id": 91003, "id": 91003, "order_label": "DID-91003", "number": "+442079460003", "status": { "code": "rejected", "label": "Rejected" }, "destination": { "country": "United Kingdom", "region": "London demo" }, "fees": { "monthly": 2, "per_minute": 0.01, "connection_fee": 0, "renewal_date": null }, "created_at": "2026-01-15 12:00:00+00:00", "regulation": { "status": "rejected", "requires_action": true, "rejected": true, "can_resubmit": true, "documents_required": true, "address_required": false, "identity_required": false, "document_labels": [ "Proof of address" ], "rejection_reasons": [ "The demo document needs review." ], "message": "Provide the required information." } } ] } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable", "completed", "pending-documents", "rejected" ], "default": "success" }, "description": "Select the response scenario for this request." } ] }, "post": { "tags": [ "dids" ], "summary": "Create DID order", "description": "If the number requires regulation or KYC, the response indicates the next step. Duplicate-charge protection is enabled; the Playground generates its retry key automatically.\n\n## Before you start\n\nObtain a quote and use its pricing fingerprint with an Idempotency-Key.\n\n## Response\n\nStore the returned order ID and follow its status and document requirements.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`, `unavailable`, `completed`, `pending-documents`, `rejected`, `quote-changed`, `insufficient-credit`.", "operationId": "didOrdersCreate", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/phone-numbers/create-did-order/" }, "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable", "unavailable", "completed", "pending-documents", "rejected", "quote-changed", "insufficient-credit" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "country_iso": { "type": "string" }, "region_code": { "type": "string" }, "number_type": { "type": "string" }, "product_reference": { "type": "string" }, "pricing_fingerprint": { "type": "string" }, "quantity": { "type": "integer" }, "browse_mode": { "type": "boolean" }, "numbers": { "type": "array", "items": { "type": "string" } }, "documents": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "regulation_address": { "type": "object", "additionalProperties": true }, "regulation_identity": { "type": "object", "additionalProperties": true } }, "required": [ "country_iso", "product_reference", "pricing_fingerprint" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "data": { "type": "object", "additionalProperties": false, "properties": { "product_reference": { "type": "string" }, "order": { "type": "object", "additionalProperties": false, "properties": { "order_id": { "type": "integer" }, "order_ids": { "type": "array", "items": { "type": "integer" } }, "order_reference": { "type": "string" }, "status": { "type": "string" }, "number": { "type": "string" }, "numbers": { "type": "array", "items": { "type": "string" } }, "requested_quantity": { "type": "integer" }, "quantity_fulfilled": { "type": "integer" }, "created_at": { "type": "string" } }, "required": [ "order_id", "order_ids", "order_reference", "status", "number", "numbers", "requested_quantity", "quantity_fulfilled", "created_at" ] }, "payment": { "type": "object", "additionalProperties": false, "properties": { "currency": { "type": "string" }, "quantity": { "type": "integer" }, "per_number": { "type": "object", "additionalProperties": false, "properties": { "setup": { "type": "integer" }, "monthly": { "type": "integer" }, "per_minute": { "type": "number" }, "connection_fee": { "type": "number", "nullable": true }, "prorated": { "type": "number" } }, "required": [ "setup", "monthly", "per_minute", "connection_fee", "prorated" ] }, "totals": { "type": "object", "additionalProperties": false, "properties": { "setup": { "type": "integer" }, "prorated": { "type": "number" }, "second_month": { "type": "integer" }, "due_now": { "type": "number" } }, "required": [ "setup", "prorated", "second_month", "due_now" ] } }, "required": [ "currency", "quantity", "per_number", "totals" ] }, "regulation": { "type": "object", "additionalProperties": false, "properties": { "required": { "type": "boolean" }, "documents_required": { "type": "boolean" }, "address_required": { "type": "boolean" }, "identity_required": { "type": "boolean" } }, "required": [ "required", "documents_required", "address_required", "identity_required" ] } }, "required": [ "product_reference", "order", "payment", "regulation" ] }, "meta": { "type": "object", "additionalProperties": false, "properties": { "country_iso": { "type": "string" }, "region_code": { "type": "string" }, "number_type": { "type": "string" } }, "required": [ "country_iso", "region_code", "number_type" ] } }, "required": [ "status", "data", "meta" ] }, "example": { "status": "success", "data": { "product_reference": "didpr_demo_gb_local", "order": { "order_id": 91001, "order_ids": [ 91001 ], "order_reference": "CART-DEMO-91001", "status": "active", "number": "+442079460001", "numbers": [ "+442079460001" ], "requested_quantity": 1, "quantity_fulfilled": 1, "created_at": "2026-01-15 12:00:00+00:00" }, "payment": { "currency": "EUR", "quantity": 1, "per_number": { "setup": 1, "monthly": 2, "per_minute": 0.01, "connection_fee": 0, "prorated": 1 }, "totals": { "setup": 1, "prorated": 1, "second_month": 2, "due_now": 4 } }, "regulation": { "required": false, "documents_required": false, "address_required": false, "identity_required": false } }, "meta": { "country_iso": "GB", "region_code": "20", "number_type": "local" } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "402": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } } } }, "/api/v1/dids/orders/quote": { "post": { "tags": [ "dids" ], "summary": "Quote DID order", "description": "Send the opaque `product_reference` from number search. Use the returned public `quote.fingerprint` as `pricing_fingerprint` when creating the order. `per_number.connection_fee` is charged once per connected incoming call, separately from the per-minute usage rate. It is not included in `totals.due_now` or monthly rental. Version 2 quotes include this fee; display it before the customer confirms.\n\n## Before you start\n\nSelect the number and rental choices before creating an order.\n\n## Response\n\nReview rental, setup and calling charges; pass pricing_fingerprint into the order request.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`, `unavailable`.", "operationId": "didOrdersQuote", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/phone-numbers/quote-did-order/" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "country_iso": { "type": "string" }, "region_code": { "type": "string" }, "number_type": { "type": "string" }, "product_reference": { "type": "string" }, "quantity": { "type": "integer" } }, "required": [ "product_reference" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "data": { "type": "object", "additionalProperties": false, "properties": { "product_reference": { "type": "string" }, "criteria": { "type": "object", "additionalProperties": false, "properties": { "country_iso": { "type": "string" }, "region_code": { "type": "string" }, "number_type": { "type": "string" } }, "required": [ "country_iso", "region_code", "number_type" ] }, "quote": { "type": "object", "additionalProperties": false, "properties": { "version": { "type": "integer" }, "fingerprint": { "type": "string" }, "pricing_date": { "type": "string" }, "issued_at": { "type": "string" }, "expires_at": { "type": "string" }, "currency": { "type": "string" }, "quantity": { "type": "integer" }, "per_number": { "type": "object", "additionalProperties": false, "properties": { "setup": { "type": "integer" }, "monthly": { "type": "integer" }, "per_minute": { "type": "number" }, "connection_fee": { "type": "number", "nullable": true }, "prorated": { "type": "number" }, "second_month": { "type": "integer" } }, "required": [ "setup", "monthly", "per_minute", "connection_fee", "prorated", "second_month" ] }, "totals": { "type": "object", "additionalProperties": false, "properties": { "setup": { "type": "integer" }, "prorated": { "type": "number" }, "second_month": { "type": "integer" }, "due_now": { "type": "number" } }, "required": [ "setup", "prorated", "second_month", "due_now" ] }, "proration": { "type": "object", "additionalProperties": false, "properties": { "remaining_days": { "type": "integer" }, "days_in_month": { "type": "integer" } }, "required": [ "remaining_days", "days_in_month" ] } }, "required": [ "version", "fingerprint", "pricing_date", "issued_at", "expires_at", "currency", "quantity", "per_number", "totals", "proration" ] } }, "required": [ "product_reference", "criteria", "quote" ] } }, "required": [ "status", "data" ] }, "example": { "status": "success", "data": { "product_reference": "didpr_demo_gb_local", "criteria": { "country_iso": "GB", "region_code": "20", "number_type": "local" }, "quote": { "version": 2, "fingerprint": "didqt_demo_ff822744d493915f11b42d958f1d02c7", "pricing_date": "2026-01-15", "issued_at": "2026-01-15 12:00:00+00:00", "expires_at": "2099-01-01 00:00:00+00:00", "currency": "EUR", "quantity": 1, "per_number": { "setup": 1, "monthly": 2, "per_minute": 0.01, "connection_fee": 0, "prorated": 1, "second_month": 2 }, "totals": { "setup": 1, "prorated": 1, "second_month": 2, "due_now": 4 }, "proration": { "remaining_days": 15, "days_in_month": 30 } } } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable", "unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/dids/orders/cancel": { "post": { "tags": [ "dids" ], "summary": "Cancel DID number", "description": "Use this to stop future renewals and release the number.\n\n## Before you start\n\nConfirm the exact number order and its current state before requesting cancellation.\n\n## Response\n\nRead the cancellation result and any continuing service conditions.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "didOrdersCancel", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/phone-numbers/cancel-did-number/" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "order_id": { "type": "integer" } }, "required": [ "order_id" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "message": { "type": "string" } }, "required": [ "status", "message" ] }, "example": { "status": "success", "message": "Cancellation requested." } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "402": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/dids/orders/documents": { "post": { "tags": [ "dids" ], "summary": "Upload DID documents", "description": "Use this when additional paperwork is required after checkout.\n\n## Before you start\n\nUse the order ID and upload the documented files required for that order.\n\n## Response\n\nCheck whether the documents were accepted for review and follow the order status.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "didOrdersDocuments", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/phone-numbers/upload-did-documents/" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "order_id": { "type": "integer" }, "documents": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "name": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "type", "value" ] } } }, "required": [ "order_id", "documents" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "message": { "type": "string" }, "data": { "type": "object", "additionalProperties": false, "properties": { "order_id": { "type": "integer" }, "stored": { "type": "integer" } }, "required": [ "order_id", "stored" ] } }, "required": [ "status", "message", "data" ] }, "example": { "status": "success", "message": "Documents stored.", "data": { "order_id": 91001, "stored": 1 } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "402": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/dids/orders/resubmit-regulation": { "post": { "tags": [ "dids" ], "summary": "Resubmit regulation", "description": "Use this when the order requests corrected or missing regulatory information. Supply every required document using its listed name (for example, Proof of Address). Repeated identical submissions are handled automatically. Pending verification, activated and cancelled orders do not accept a new submission. A successful response may confirm that documents were saved for our team to review; it does not mean the number is active.\n\n## Before you start\n\nCorrect the requested documents or information on the existing order.\n\n## Response\n\nRead whether verification can resume or whether further review is required.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "operationId": "didOrdersResubmit", "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/api/phone-numbers/resubmit-regulation/" }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "order_id": { "type": "integer" }, "documents": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "name": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "type", "value" ] } } }, "required": [ "order_id" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "message": { "type": "string" }, "data": { "type": "object", "additionalProperties": false, "properties": { "order_id": { "type": "integer" } }, "required": [ "order_id" ] } }, "required": [ "status", "message", "data" ] }, "example": { "status": "success", "message": "Documents submitted. Verification will resume shortly.", "data": { "order_id": 91001 } } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "402": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ] } }, "/api/v1/voice/calls": { "post": { "operationId": "voiceCompatibilityCreate", "summary": "Create call (compatibility)", "description": "Create an outbound call using a SIP identity, destination and optional caller ID.\n\n## Before you start\n\nProvide the destination in to and the supported call options.\n\n## Response\n\nRead request_id, sip_user_id and to in the response.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } }, { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "to": { "type": "string" }, "sip_user_id": { "type": "string" }, "from": { "type": "string" }, "timeout_seconds": { "type": "integer" } }, "required": [ "to" ], "additionalProperties": true } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string" }, "request_id": { "type": "string" }, "sip_user_id": { "type": "string" }, "to": { "type": "string" } }, "required": [ "status", "request_id", "sip_user_id", "to" ], "additionalProperties": false }, "example": { "status": "success", "request_id": "vapi_111111111111111111111111", "sip_user_id": "900001", "to": "442079460001" } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "402": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/sandbox/" } } }, "/api/v1/voice/calls/hangup": { "post": { "operationId": "voiceCompatibilityHangup", "summary": "End call (compatibility)", "description": "End the call identified by call_id.\n\n## Before you start\n\nProvide the call_id for the call to end.\n\n## Response\n\nRead the returned status and message.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "call_id": { "type": "string" }, "digits": { "type": "string" }, "to": { "type": "string" }, "target": { "type": "string" }, "leg": { "type": "string", "enum": [ "caller", "callee" ] } }, "required": [ "call_id" ], "additionalProperties": true } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string" }, "message": { "type": "string" } }, "required": [ "status", "message" ], "additionalProperties": false }, "example": { "status": "success", "message": "Call terminated." } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/sandbox/" } } }, "/api/v1/voice/calls/dtmf": { "post": { "operationId": "voiceCompatibilityDtmf", "summary": "Send DTMF (compatibility)", "description": "Send DTMF digits to the call identified by call_id.\n\n## Before you start\n\nProvide call_id and digits.\n\n## Response\n\nRead the returned status and message.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "call_id": { "type": "string" }, "digits": { "type": "string" }, "to": { "type": "string" }, "target": { "type": "string" }, "leg": { "type": "string", "enum": [ "caller", "callee" ] } }, "required": [ "call_id", "digits" ], "additionalProperties": true } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string" }, "message": { "type": "string" } }, "required": [ "status", "message" ], "additionalProperties": false }, "example": { "status": "success", "message": "DTMF sent." } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/sandbox/" } } }, "/api/v1/voice/calls/transfer": { "post": { "operationId": "voiceCompatibilityTransfer", "summary": "Transfer call (compatibility)", "description": "Transfer the call identified by call_id to another destination.\n\n## Before you start\n\nProvide call_id and the destination in to.\n\n## Response\n\nRead the returned status, message and destination.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "call_id": { "type": "string" }, "digits": { "type": "string" }, "to": { "type": "string" }, "target": { "type": "string" }, "leg": { "type": "string", "enum": [ "caller", "callee" ] } }, "required": [ "call_id", "to" ], "additionalProperties": true } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string" }, "message": { "type": "string" }, "to": { "type": "string" } }, "required": [ "status", "message", "to" ], "additionalProperties": false }, "example": { "status": "success", "message": "Call transferred.", "to": "442079460001" } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "402": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/sandbox/" } } }, "/api/v1/voice/call-control/send-dtmf": { "post": { "operationId": "voiceControlSendDtmf", "summary": "Send DTMF", "description": "Useful for external IVRs after a programmable prompt or transfer.\n\n## Before you start\n\nUse an active control session and the documented digits/duration options.\n\n## Response\n\nRead whether the tones were accepted for that call.\n\n## Scenarios\n\nChoose a scenario in Playground or send `X-Illyvoip-Sandbox-Scenario`. Available values: `success`, `not-found`, `rate-limited`, `forbidden`, `service-unavailable`.", "parameters": [ { "name": "X-Illyvoip-Sandbox-Scenario", "in": "header", "required": false, "schema": { "type": "string", "enum": [ "success", "not-found", "rate-limited", "forbidden", "service-unavailable" ], "default": "success" }, "description": "Select the response scenario for this request." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "call_control_id": { "type": "string", "nullable": false }, "digits": { "type": "string" }, "timeout_ms": { "type": "integer" }, "duration_ms": { "type": "integer" } }, "required": [ "call_control_id", "digits" ] } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "success" ] }, "call_control_id": { "type": "string", "nullable": false }, "digits": { "type": "string" } }, "required": [ "status", "call_control_id", "digits" ] }, "example": { "status": "success", "call_control_id": "vapi_111111111111111111111111", "digits": "1" } } }, "description": "Successful response" }, "400": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "401": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "403": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "404": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "409": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "429": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "500": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" }, "503": { "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "status", "message" ], "properties": { "status": { "type": "string", "enum": [ "error" ] }, "message": { "type": "string" }, "error_code": { "type": "string", "nullable": true }, "fields": { "type": "object", "additionalProperties": true } } } } }, "description": "Request could not be completed" } }, "security": [ { "apiKeyAuth": [] } ], "externalDocs": { "description": "Public reference", "url": "https://illyvoip.com/docs/sandbox/" } } } }, "components": { "securitySchemes": { "apiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-Api-Key" }, "sipBrowserTokenAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT" } } } }