> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# SMS Conversation Analysis

> Answer questions and extract information from an SMS conversation.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Body

**schema\_id** `string` *required*

The ID of the citation schema to use for extracting variables from the SMS conversation.

**conversation\_id** `string` *required*

The ID of the SMS conversation to analyze.

### Response

**data** `object`

The response data containing analysis results.

**data**

**status** `string`

The status of the analysis operation. Returns "success" on successful completion.

**conversation\_id** `string`

The ID of the SMS conversation that was analyzed.

**schema\_id** `string`

The ID of the citation schema that was used for analysis.

**schema\_name** `string`

The name of the citation schema that was used.

**variables\_extracted** `number`

The total number of variables that were successfully extracted from the conversation.

**extracted\_variables** `object`

An object containing the extracted variables as key-value pairs, where keys are variable names and values are the extracted data.

**citations** `array`

An array of citation objects that reference where each variable was found in the conversation.

**citation object**

**variable** `string`

The name of the variable this citation references.

**message** `string`

The message text where the variable was found.

**confidence** `number`

The confidence score (0-1) for this extraction.

**messages\_processed** `number`

The total number of messages in the conversation that were processed.

**errors** `array`

An array of error objects. Empty array when the request is successful.

```json Response theme={null}
{
    "data": {
        "status": "success",
        "conversation_id": "conv_123456",
        "schema_id": "schema_789",
        "schema_name": "Customer Intent Analysis",
        "variables_extracted": 5,
        "extracted_variables": {
            "customer_name": "John Smith",
            "preferred_time": "morning",
            "service_type": "moving",
            "urgency": "high",
            "budget_range": "$500-1000"
        },
        "citations": [
            {
                "variable": "customer_name",
                "message": "Hi, this is John Smith calling about...",
                "confidence": 0.95
            }
        ],
        "messages_processed": 12
    },
    "errors": []
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.