Brevo

brevo SMS Statistics API

Retrieve delivery reports and activity statistics for transactional SMS messages.

GitHub OpenAPI

Operations 3

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /transactionalSMS/statistics/events List transactional SMS events · Get transactional SMS activity events #
Ask an LLM
“Was a transactional text to a specific phone number delivered?”
“Can I list only the bounced transactional SMS events?”
Tell an agent
List transactional SMS events for {phoneNumber}.
Show {event} SMS events between {startDate} and {endDate}.
GET /transactionalSMS/statistics/reports Get daily transactional SMS stats · Get transactional SMS statistics reports #
Ask an LLM
“How many transactional texts were delivered each day this week?”
“Can I get per-day SMS delivery stats for a single tag?”
Tell an agent
Show per-day transactional SMS stats for the last {days} days.
Give me daily SMS delivery numbers for tag {tag} from {startDate} to {endDate}.
GET /transactionalSMS/statistics/aggregatedReport Get total transactional SMS stats for a period · Get aggregated transactional SMS statistics #
Ask an LLM
“What's my total number of transactional texts sent and bounced this month?”
“Can I get one overall SMS total for a tag?”
Tell an agent
Get aggregated transactional SMS totals from {startDate} to {endDate}.
Sum up SMS sent, delivered and bounced for tag {tag} over {days} days.

Documentation

📖
Documentation
https://developers.brevo.com/docs/send-a-transactional-email
📖
Documentation
https://developers.brevo.com/docs/getting-started
📖
Documentation
https://developers.brevo.com/docs/how-it-works
📖
Documentation
https://developers.brevo.com/docs/transactional-sms-endpoints
📖
Documentation
https://developers.brevo.com/docs/whatsapp-messages
📖
Documentation
https://developers.brevo.com/docs/import-your-products
📖
Documentation
https://developers.brevo.com/docs/transactional-webhooks

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/brevo/refs/heads/main/openapi/brevo-sms-statistics-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/brevo/refs/heads/main/asyncapi/brevo-webhooks-asyncapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/brevo:brevo-sms-statistics-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

brevo-sms-statistics-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Brevo Transactional SMS SMS Statistics API
  description: The Brevo Transactional SMS API allows developers to send non-promotional SMS messages such as order confirmations, delivery notifications, and verification codes using recipients' phone numbers. It supports sending individual messages with customizable sender names and provides endpoints for tracking SMS delivery status and activity. The API is designed for time-sensitive notifications that require immediate delivery to mobile devices.
  version: '3.0'
  contact:
    name: Brevo Support
    url: https://help.brevo.com
  termsOfService: https://www.brevo.com/legal/termsofuse/
servers:
- url: https://api.brevo.com/v3
  description: Brevo Production API Server
security:
- apiKeyAuth: []
tags:
- name: SMS Statistics
  description: Retrieve delivery reports and activity statistics for transactional SMS messages.
paths:
  /transactionalSMS/statistics/events:
    get:
      operationId: getSmsEvents
      summary: Get transactional SMS activity events
      description: Retrieves detailed event-level data for transactional SMS messages including delivery status, bounces, and recipient interactions.
      tags:
      - SMS Statistics
      parameters:
      - $ref: '#/components/parameters/limitParam'
      - $ref: '#/components/parameters/offsetParam'
      - name: startDate
        in: query
        description: Start date for the event query in YYYY-MM-DD format.
        schema:
          type: string
          format: date
      - name: endDate
        in: query
        description: End date for the event query in YYYY-MM-DD format.
        schema:
          type: string
          format: date
      - name: phoneNumber
        in: query
        description: Filter events by recipient phone number.
        schema:
          type: string
      - name: event
        in: query
        description: Filter by event type such as delivered, sent, softBounce, hardBounce, or unsubscribed.
        schema:
          type: string
          enum:
          - sent
          - accepted
          - delivered
          - replied
          - softBounce
          - hardBounce
          - subscribe
          - unsubscribe
          - skip
          - rejected
      - name: tags
        in: query
        description: Filter events by tag assigned to the SMS.
        schema:
          type: string
      responses:
        '200':
          description: SMS events retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SmsEventReport'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /transactionalSMS/statistics/reports:
    get:
      operationId: getSmsReports
      summary: Get transactional SMS statistics reports
      description: Retrieves detailed delivery reports for transactional SMS messages over a specified date range. Returns per-day statistics for sent, delivered, and bounced messages.
      tags:
      - SMS Statistics
      parameters:
      - name: startDate
        in: query
        description: Start date for the report in YYYY-MM-DD format.
        schema:
          type: string
          format: date
      - name: endDate
        in: query
        description: End date for the report in YYYY-MM-DD format.
        schema:
          type: string
          format: date
      - name: days
        in: query
        description: Number of days for the report, starting from today.
        schema:
          type: integer
      - name: tag
        in: query
        description: Filter reports by tag.
        schema:
          type: string
      responses:
        '200':
          description: SMS reports retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SmsStatisticsReport'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /transactionalSMS/statistics/aggregatedReport:
    get:
      operationId: getAggregatedSmsReport
      summary: Get aggregated transactional SMS statistics
      description: Retrieves aggregated statistics for transactional SMS activity over a specified period. Returns totals for sent, delivered, and bounced messages.
      tags:
      - SMS Statistics
      parameters:
      - name: startDate
        in: query
        description: Start date for the report in YYYY-MM-DD format.
        schema:
          type: string
          format: date
      - name: endDate
        in: query
        description: End date for the report in YYYY-MM-DD format.
        schema:
          type: string
          format: date
      - name: days
        in: query
        description: Number of days for the report, starting from today.
        schema:
          type: integer
      - name: tag
        in: query
        description: Filter by tag.
        schema:
          type: string
      responses:
        '200':
          description: Aggregated SMS statistics retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AggregatedSmsReport'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    SmsEventReport:
      type: object
      properties:
        events:
          type: array
          description: List of transactional SMS activity events.
          items:
            type: object
            properties:
              phoneNumber:
                type: string
                description: Recipient phone number.
              date:
                type: string
                format: date-time
                description: UTC date-time when the event occurred.
              messageId:
                type: string
                description: Unique identifier of the SMS message.
              event:
                type: string
                description: Type of SMS event that occurred.
                enum:
                - sent
                - accepted
                - delivered
                - replied
                - softBounce
                - hardBounce
                - subscribe
                - unsubscribe
                - skip
                - rejected
              reason:
                type: string
                description: Reason for the event if applicable.
              tag:
                type: string
                description: Tag assigned to the SMS.
    ErrorResponse:
      type: object
      properties:
        code:
          type: string
          description: Error code identifying the type of error.
        message:
          type: string
          description: Human-readable description of the error.
    AggregatedSmsReport:
      type: object
      properties:
        range:
          type: string
          description: Date range for the aggregated statistics.
        requests:
          type: integer
          format: int64
          description: Total SMS send requests.
        delivered:
          type: integer
          format: int64
          description: Total successfully delivered SMS.
        hardBounces:
          type: integer
          format: int64
          description: Total hard bounces.
        softBounces:
          type: integer
          format: int64
          description: Total soft bounces.
        blocked:
          type: integer
          format: int64
          description: Total blocked SMS.
        unsubscribed:
          type: integer
          format: int64
          description: Total unsubscribes.
    SmsStatisticsReport:
      type: object
      properties:
        reports:
          type: array
          description: Daily SMS statistics reports.
          items:
            type: object
            properties:
              date:
                type: string
                format: date
                description: Date for the statistics.
              requests:
                type: integer
                format: int64
                description: Number of SMS send requests.
              delivered:
                type: integer
                format: int64
                description: Number of successfully delivered SMS.
              hardBounces:
                type: integer
                format: int64
                description: Number of hard bounces.
              softBounces:
                type: integer
                format: int64
                description: Number of soft bounces.
              blocked:
                type: integer
                format: int64
                description: Number of blocked SMS.
              unsubscribed:
                type: integer
                format: int64
                description: Number of unsubscribes.
  parameters:
    limitParam:
      name: limit
      in: query
      description: Maximum number of results to return per request.
      schema:
        type: integer
        format: int64
        default: 50
    offsetParam:
      name: offset
      in: query
      description: Number of results to skip for pagination.
      schema:
        type: integer
        format: int64
        default: 0
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: api-key
      description: Brevo API key passed in the api-key request header for authentication.
externalDocs:
  description: Brevo Transactional SMS Documentation
  url: https://developers.brevo.com/docs/transactional-sms-endpoints