> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.brevo.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.brevo.com/_mcp/server.

# Get your SMS activity aggregated per day

GET https://api.brevo.com/v3/transactionalSMS/statistics/reports

Retrieve a day-by-day breakdown of your transactional SMS activity, with each entry containing the date and counts for requests, delivered, hard bounces, soft bounces, blocked, unsubscribed, replied, accepted, rejected, and skipped messages. Filter by date range using `startDate` and `endDate` (both required together, YYYY-MM-DD format), by a number of past `days` (not compatible with date range), or by `tag`. Results are sorted in descending order by default unless overridden with the `sort` parameter.

Reference: https://developers.brevo.com/reference/get-transac-sms-report

## Authentication

- `api-key` header (required) — The API key should be passed in the request headers as `api-key` for authentication.

## Request

### Query parameters

- `startDate` (string, optional) — **Mandatory if endDate is used.** Starting date (YYYY-MM-DD) of the report
- `endDate` (string, optional) — **Mandatory if startDate is used.** Ending date (YYYY-MM-DD) of the report
- `days` (long, optional) — Number of days in the past including today (positive integer). **Not compatible with 'startDate' and 'endDate'**
- `tag` (string, optional) — Filter on a tag
- `sort` (enum, optional, default: desc) — Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed
  - Allowed values: `asc`, `desc`

## Response

### 200

Aggregated SMS report informations

- `reports` (list of object, optional)
  - `accepted` (long, optional) — Number of accepted SMS for the date
  - `blocked` (long, optional) — Number of blocked contact for the date
  - `date` (date, optional) — Date for which statistics are retrieved
  - `delivered` (long, optional) — Number of delivered SMS for the date
  - `hardBounces` (long, optional) — Number of hardbounces for the date
  - `rejected` (long, optional) — Number of rejected SMS for the date
  - `replied` (long, optional) — Number of answered SMS for the date
  - `requests` (long, optional) — Number of requests for the date
  - `skipped` (long, optional) — Number of skipped SMS for the date
  - `softBounces` (long, optional) — Number of softbounces for the date
  - `unsubscribed` (long, optional) — Number of unsubscription for the date

## Errors

### 400 Bad Request Error

bad request

- `code` (enum, required) — Error code displayed in case of a failure
  - Allowed values: `invalid_parameter`, `missing_parameter`, `out_of_range`, `campaign_processing`, `campaign_sent`, `document_not_found`, `not_enough_credits`, `permission_denied`, `duplicate_parameter`, `duplicate_request`, `method_not_allowed`, `unauthorized`, `account_under_validation`, `not_acceptable`, `bad_request`, `unprocessable_entity`, `Domain does not exist`, `Contact email not found`, `Attribute not found`, `Category id not found`, `Invalid parameters passed`, `Record(s) for identifier not found`, `Returned when query params are invalid`, `Returned when invalid data posted`, `Feed not found`, `Campaign ID not found`, `api-key not found`, `DMARC policy requires domain authentication`, `DNS records not properly configured`, `Invalid OTP code provided`, `OTP code has expired`, `Domain already exists in your account`, `The sum of all IP weights must equal 100`, `Authentication failed`, `Insufficient credits`, `Request already processed`
- `message` (string, required) — Readable message associated to the failure

## Examples

**Response**

```json
{
  "reports": [
    {
      "accepted": 2318,
      "blocked": 1026,
      "date": "2017-04-30",
      "delivered": 10103,
      "hardBounces": 21,
      "rejected": 0,
      "replied": 5091,
      "requests": 10756,
      "skipped": 1,
      "softBounces": 137,
      "unsubscribed": 720
    },
    {
      "accepted": 4393,
      "blocked": 1514,
      "date": "2017-05-01",
      "delivered": 17499,
      "hardBounces": 34,
      "rejected": 0,
      "replied": 10089,
      "requests": 18812,
      "skipped": 0,
      "softBounces": 254,
      "unsubscribed": 1090
    },
    {
      "accepted": 4689,
      "blocked": 1646,
      "date": "2017-05-02",
      "delivered": 13427,
      "hardBounces": 16,
      "rejected": 0,
      "replied": 11563,
      "requests": 14321,
      "skipped": 1,
      "softBounces": 176,
      "unsubscribed": 1170
    }
  ]
}
```

**SDK Code**

```typescript response
import { BrevoClient } from "@getbrevo/brevo";

async function main() {
    const client = new BrevoClient({
        apiKey: "YOUR_API_KEY_HERE",
    });
    await client.transactionalSms.getTransacSmsReport({});
}
main();

```

```python response
from brevo import Brevo

client = Brevo(
    api_key="YOUR_API_KEY_HERE",
)

client.transactional_sms.get_transac_sms_report()

```

```php response
<?php

namespace Example;

use Brevo\Brevo;
use Brevo\TransactionalSms\Requests\GetTransacSmsReportRequest;

$client = new Brevo(
    apiKey: 'YOUR_API_KEY_HERE',
);
$client->transactionalSms->getTransacSmsReport(
    new GetTransacSmsReportRequest([]),
);

```

```go response
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.brevo.com/v3/transactionalSMS/statistics/reports"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api-key", "<apiKey>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby response
require 'uri'
require 'net/http'

url = URI("https://api.brevo.com/v3/transactionalSMS/statistics/reports")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api-key"] = '<apiKey>'

response = http.request(request)
puts response.read_body
```

```java response
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.brevo.com/v3/transactionalSMS/statistics/reports")
  .header("api-key", "<apiKey>")
  .asString();
```

```csharp response
using RestSharp;

var client = new RestClient("https://api.brevo.com/v3/transactionalSMS/statistics/reports");
var request = new RestRequest(Method.GET);
request.AddHeader("api-key", "<apiKey>");
IRestResponse response = client.Execute(request);
```

```swift response
import Foundation

let headers = ["api-key": "<apiKey>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.brevo.com/v3/transactionalSMS/statistics/reports")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```