---
title: "SMS Summary"
method: POST
path: "/sms/summary"
tags: ["SMS"]
---

# SMS Summary

`POST /sms/summary`

Retrieve a summary of SMS messages within a certain time range.

## Request body

- object
  - `start_date` string, date — ISO-8601 formatted datetime which defaults to current date at midnight. The range will be inclusive of start_date and exclusive of end_date. Timezone is UTC.
  - `end_date` string, date — ISO-8601 formatted datetime which defaults to now. Timezone is UTC.
  - `subaccount_id` string — If you wish to make this API call on behalf of a subaccount then include its unique ID here.

## Response `200`

Summary of SMS activity

- object
  - `data` object, required
    - `total_messages` integer — The total number of SMS messages sent within the passed time range
    - `total_units` integer — The total number of SMS units used to send the messages within the passed time range
    - `total_cost` number — The total cost of the SMS messages within the passed time range
  - `request_id` string, required

## Other responses

- `400` — 400

---

[API](https://skmtc.net/smtp2go/apis/smtp2go-api-v3-0-4.md) · [All operations](https://skmtc.net/smtp2go/apis/smtp2go-api-v3-0-4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smtp2go/smtp2go-api-v3-0-4/versions/1ba6b25eebb9/schema)