---
updatedAt: 2026-09-09T20:52:23.000Z
agentTools:
  projectIndex: https://authenticx.readme.io/llms.txt
---

# Get Batched Conversation Transcriptions

Returns the transcriptions for multiple conversations identified by their unique IDs.
Up to 100 conversation IDs are accepted per request. Duplicate IDs are ignored.
            
Response includes:
- transcriptions: successful items
- errors: failed items, each with a statusCode indicating why it failed
  * 404 = conversation not found
  * 400 = failed to process
  * 200 = not processed or still processing (message included)
            
Example request:
{
  "conversationIds": [
    "b1a9e4d6-7c3a-4e91-9342-835ec9d4f7b1",
    "ad5b1e2f-08b9-4b23-9e0c-d1a1c3eafc2f"
  ]
}
            
Example response:
{
  "transcriptions": [
    {
      "conversationId": "b1a9e4d6-7c3a-4e91-9342-835ec9d4f7b1",
      "transcriptions": [
        {
          "languageCode": "en",
          "transcription": [
            "00:00 Agent: Hello",
            "00:03 Customer: Hi"
          ]
        }
      ]
    }
  ],
  "errors": [
    {
      "conversationId": "ad5b1e2f-08b9-4b23-9e0c-d1a1c3eafc2f",
      "statusCode": 404,
      "error": "Conversation not found"
    }
  ]
}

**Common next steps after a** `POST /Agent/` **call:**

* Items with error status `200` may become available after processing completes. Retry those IDs later.
* Items with status `404` or `400` indicate a permanent issue with that conversation record.
* Use returned transcription text for bulk export, compliance review, or downstream NLP processing.

# OpenAPI definition

```json
{
  "openapi": "3.0.4",
  "info": {
    "title": "AcxApi Production",
    "version": "v1"
  },
  "servers": [
    {
      "url": "https://api.beauthenticx.com",
      "description": "AcxApi Production Server"
    }
  ],
  "paths": {
    "/Conversations/Transcriptions": {
      "post": {
        "tags": [
          "Conversations"
        ],
        "summary": "Get Batched Conversation Transcriptions",
        "description": "Returns the transcriptions for multiple conversations identified by their unique IDs.\nUp to 100 conversation IDs are accepted per request. Duplicate IDs are ignored.\n            \nResponse includes:\n- transcriptions: successful items\n- errors: failed items, each with a statusCode indicating why it failed\n  * 404 = conversation not found\n  * 400 = failed to process\n  * 200 = not processed or still processing (message included)\n            \nExample request:\n{\n  \"conversationIds\": [\n    \"b1a9e4d6-7c3a-4e91-9342-835ec9d4f7b1\",\n    \"ad5b1e2f-08b9-4b23-9e0c-d1a1c3eafc2f\"\n  ]\n}\n            \nExample response:\n{\n  \"transcriptions\": [\n    {\n      \"conversationId\": \"b1a9e4d6-7c3a-4e91-9342-835ec9d4f7b1\",\n      \"transcriptions\": [\n        {\n          \"languageCode\": \"en\",\n          \"transcription\": [\n            \"00:00 Agent: Hello\",\n            \"00:03 Customer: Hi\"\n          ]\n        }\n      ]\n    }\n  ],\n  \"errors\": [\n    {\n      \"conversationId\": \"ad5b1e2f-08b9-4b23-9e0c-d1a1c3eafc2f\",\n      \"statusCode\": 404,\n      \"error\": \"Conversation not found\"\n    }\n  ]\n}",
        "requestBody": {
          "description": "Request containing conversation IDs. Maximum 100 conversation IDs per request.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AcxApi.Models.Transcription.BatchTranscriptionRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/AcxApi.Models.Transcription.BatchTranscriptionRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/AcxApi.Models.Transcription.BatchTranscriptionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns the transcriptions for the specified conversations",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AcxApi.Models.Transcription.BatchTranscriptionResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - invalid input or exceeds maximum batch size"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "AcxApi.Models.Transcription.BatchTranscriptionError": {
        "type": "object",
        "properties": {
          "conversationId": {
            "type": "string",
            "description": "The conversation ID that failed.",
            "format": "uuid",
            "example": "ad5b1e2f-08b9-4b23-9e0c-d1a1c3eafc2f"
          },
          "statusCode": {
            "type": "integer",
            "description": "HTTP status code representing the failure.",
            "format": "int32",
            "example": 404
          },
          "error": {
            "type": "string",
            "description": "Error message explaining the failure.",
            "nullable": true,
            "example": "Conversation not found"
          }
        },
        "additionalProperties": false
      },
      "AcxApi.Models.Transcription.BatchTranscriptionRequest": {
        "required": [
          "conversationIds"
        ],
        "type": "object",
        "properties": {
          "conversationIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "List of conversation IDs to retrieve transcriptions for. Maximum 100 IDs per request. Duplicate IDs are ignored.",
            "example": [
              "b1a9e4d6-7c3a-4e91-9342-835ec9d4f7b1",
              "ad5b1e2f-08b9-4b23-9e0c-d1a1c3eafc2f"
            ]
          }
        },
        "additionalProperties": false
      },
      "AcxApi.Models.Transcription.BatchTranscriptionResponse": {
        "type": "object",
        "properties": {
          "transcriptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AcxApi.Models.Transcription.ConversationTranscriptionResponse"
            },
            "description": "Successfully retrieved transcriptions. Each item has the same shape as the GET /Conversations/Transcriptions/{conversationId} response.",
            "nullable": true,
            "example": [
              {
                "conversationId": "b1a9e4d6-7c3a-4e91-9342-835ec9d4f7b1",
                "transcriptions": [
                  {
                    "languageCode": "en",
                    "transcription": [
                      "00:00 Agent: Hello",
                      "00:03 Customer: Hi"
                    ]
                  }
                ]
              }
            ]
          },
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AcxApi.Models.Transcription.BatchTranscriptionError"
            },
            "description": "Items that could not be retrieved. Each error includes ConversationId, StatusCode (404=not found, 400=failed to process, 200=still processing), and an Error message. Null if all items succeeded.",
            "nullable": true,
            "example": [
              {
                "conversationId": "ad5b1e2f-08b9-4b23-9e0c-d1a1c3eafc2f",
                "statusCode": 404,
                "error": "Conversation not found"
              }
            ]
          }
        },
        "additionalProperties": false
      },
      "AcxApi.Models.Transcription.ConversationTranscriptionResponse": {
        "type": "object",
        "properties": {
          "conversationId": {
            "type": "string",
            "description": "The unique identifier of the conversation.",
            "format": "uuid",
            "example": "b1a9e4d6-7c3a-4e91-9342-835ec9d4f7b1"
          },
          "transcriptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AcxApi.Models.Transcription.Transcriptions"
            },
            "description": "List of transcription objects, each with a LanguageCode (ISO language code, e.g. en) and a Transcription array of formatted strings in the format HH:MM:SS Speaker: text.",
            "nullable": true,
            "example": [
              {
                "languageCode": "en",
                "transcription": [
                  "00:00 Agent: Hello",
                  "00:03 Customer: Hi"
                ]
              }
            ]
          }
        },
        "additionalProperties": false
      },
      "AcxApi.Models.Transcription.Transcriptions": {
        "type": "object",
        "properties": {
          "languageCode": {
            "type": "string",
            "description": "Two Letter ISO Language Code.",
            "nullable": true,
            "example": "en"
          },
          "transcription": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Array of formatted transcription lines in the format HH:MM:SS Speaker: text.",
            "nullable": true,
            "example": [
              "00:00 Agent: Hello",
              "00:03 Customer: Hi"
            ]
          }
        },
        "additionalProperties": false
      }
    }
  },
  "security": [
    {}
  ],
  "tags": [
    {
      "name": "Conversations"
    }
  ]
}
```