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

# Get Sendflow Reports Summary

> Returns aggregated sendflow metrics

#### Description

This endpoint returns aggregated Sendflow metrics for a specific flow. You can filter by date range, channels, and countries. Results are cached for 5 minutes for the same workspace and query.

#### Headers

<ParamField header="x-api-key" type="string" required placeholder="Enter your API key">
  Your API key for authentication.
</ParamField>

<ParamField header="x-workspace-id" type="string" required placeholder="Enter your workspace ID">
  Your workspace ID for authentication.
</ParamField>

#### Path Parameters

<ParamField path="flowId" type="string" required placeholder="65f1a2b3c4d5e6f7a8b9c0d1">
  The unique identifier of the Sendflow.
</ParamField>

#### Query Parameters

<ParamField query="start_date" type="string" placeholder="2024-01-01T00:00:00Z">
  Start date in RFC3339 or `YYYY-MM-DD` format.
</ParamField>

<ParamField query="end_date" type="string" placeholder="2024-01-31T00:00:00Z">
  End date in RFC3339 or `YYYY-MM-DD` format.
</ParamField>

<ParamField query="channels" type="string" placeholder="whatsapp,sms">
  Comma-separated channels. Possible values: `sms`, `email`, `whatsapp`, `rcs`.
</ParamField>

<ParamField query="countries" type="string" placeholder="US,IN">
  Comma-separated ISO country codes.
</ParamField>

#### Response

<ResponseField name="success" type="boolean">
  Indicates whether the API call was successful.
</ResponseField>

<ResponseField name="message" type="string">
  Success or error message from the API.
</ResponseField>

<ResponseField name="data" type="object">
  Aggregated Sendflow metrics containing:
</ResponseField>

<ResponseField name="data.requests" type="integer">
  Total number of Sendflow requests.
</ResponseField>

<ResponseField name="data.submitted" type="integer">
  Number of messages submitted.
</ResponseField>

<ResponseField name="data.sent" type="integer">
  Number of messages sent.
</ResponseField>

<ResponseField name="data.delivered" type="integer">
  Number of messages delivered.
</ResponseField>

<ResponseField name="data.acknowledged" type="integer">
  Number of messages acknowledged.
</ResponseField>

<ResponseField name="data.failed" type="integer">
  Number of failed executions or deliveries.
</ResponseField>

<ResponseField name="data.cost" type="number">
  Total cost for the selected period.
</ResponseField>

<ResponseExample>
  ```json 200-Success theme={null}
  {
    "success": true,
    "message": "Sendflow reports summary retrieved successfully",
    "data": {
      "requests": 800,
      "submitted": 790,
      "sent": 770,
      "delivered": 740,
      "acknowledged": 710,
      "failed": 20,
      "cost": 42.8
    }
  }
  ```

  ```json 400-Bad Request theme={null}
  {
    "success": false,
    "message": "Invalid flowId or query parameter"
  }
  ```

  ```json 401-Unauthorized theme={null}
  {
    "success": false,
    "message": "Unauthorized. Please check your API key and workspace ID."
  }
  ```

  ```json 429-Too Many Requests theme={null}
  {
    "success": false,
    "message": "Too many requests, try again later!"
  }
  ```

  ```json 500-Internal Server Error theme={null}
  {
    "success": false,
    "message": "Internal server error. Please try again later."
  }
  ```
</ResponseExample>