SMS

Recent SMS delivery reports

GET /v1/sms/delivery-reports

Scope

sms:read

Tier

Tier 1

Data

Personal data

Idempotency

Idempotency-Key: not used

The most recent outbound SMS of the account, newest first, up to limit (not paginated in v1). The message text is not returned. status is what the provider reported; delivered needs a carrier receipt, which not every route sends.

Parameters

Response

200: The reports.

Examples

Request example

curl

curl -sS -X GET \
  "https://app.dialerbee.com/api/v1/sms/delivery-reports" \
  -H "Authorization: Bearer $DIALERBEE_API_KEY"

Python (SDK)

from dialerbee import DialerBee

db = DialerBee()  # reads DIALERBEE_API_KEY from the environment

result = db.sms.delivery_reports()

Response example

200

{
  "data": [
    {
      "id": "msg_0f8fad5b-d9cb-469f-a165-70867728950e",
      "to": "+12125550123",
      "status": "delivered",
      "sent_at": "2026-09-29T12:00:00Z",
      "delivered_at": "2026-09-29T12:00:02Z",
      "sender_id": "ExampleCo",
      "error": null
    }
  ]
}

Error examples

403 insufficient_scope

{
  "type": "https://docs.dialerbee.com/errors/insufficient-scope",
  "title": "Not permitted",
  "status": 403,
  "detail": "The API client does not hold the scope this operation requires.",
  "instance": "urn:dialerbee:request:req_01K6BZ3M9X4T7Q2V8N5R6P1W0C",
  "code": "insufficient_scope",
  "request_id": "req_01K6BZ3M9X4T7Q2V8N5R6P1W0C"
}

401 invalid_api_key

{
  "type": "https://docs.dialerbee.com/errors/invalid-api-key",
  "title": "Invalid API key",
  "status": 401,
  "detail": "The Authorization header is missing, is not Bearer dbk_live_..., or the key is not recognised, has expired or was revoked (one answer for every key problem, so a key's state is never revealed).",
  "instance": "urn:dialerbee:request:req_01K6BZ3M9X4T7Q2V8N5R6P1W0C",
  "code": "invalid_api_key",
  "request_id": "req_01K6BZ3M9X4T7Q2V8N5R6P1W0C"
}

Errors

Objects

SmsDeliveryReportList

SmsDeliveryReport