---
title: "Get delivery reports by ad hoc criteria"
method: GET
path: "/reports/delivery"
tags: ["reports"]
---

# Get delivery reports by ad hoc criteria

`GET /reports/delivery`

Get delivery reports

## Query parameters

- `startDate` string
- `endDate` string
- `limit` integer
- `offset` integer
- `campaignId` integer
- `fromNumber` string
- `toNumber` string
- `deliveryCategory` 'NO_DATA' | 'OPTED_OUT' | 'BOUNCED' | 'NO_CREDITS' | 'DELIVERED'
- `deliveryState` 'DELIVERED' | 'UNSENT_OPTED_OUT_GLOBAL' | 'UNSENT_OPTED_OUT_LOCAL' | 'UNSENT_NO_CREDITS' | 'GATEWAY_REJECTED' | 'CARRIER_REJECTED' | 'NOT_DELIVERED' | 'UNSENT_INVALID_NUMBER' | 'UNSENT_BAD_DATA' | 'UNSENT_FORCE_STOPPED' | 'UNSENT_PERIOD_LIMIT' | 'UNSENT_INTERNATIONAL' | 'UNSENT_INVALID_TIMEZONE_OR_DNC' | 'UNSENT_ALREADY_SCRUBBED' | 'UNSENT_SYSTEM_ERROR' | 'UNSENT_NO_WIRELESS_CARRIER' | 'UNSENT_MESSAGE_TOO_LONG' | 'UNSENT_MESSAGE_BLOCKED' | 'UNSENT_NON_A2P_BLOCKED' | 'UNSENT_A2P_NOT_ENABLED_BLOCKED' | 'UNSENT_QUEUE_LIMIT_REACHED' | 'UNSENT_TOKEN_LIMIT_REACHED' | 'UNSENT_TIME_LIMIT_REACHED' | 'UNSENT_SCHEDULER_CAPACITY_EXCEEDED' | 'SPAM_DETECTED' | 'UNSENT_NO_GATEWAY' | 'UNSENT_DAILY_LIMIT_REACHED' | 'ORIGINATED' | 'SUBMITTED' | 'FORWARDED' | 'NOT_GIVEN' | 'UNKNOWN' | 'RETRY_MMS_AS_SMS' | 'QUEUED' | 'QUEUED_TRANSCODE' | 'ORIGINAL' | 'DUPE' | 'CONNECTOR_SELECTED' | 'TRUNCATED' | 'REQUEUED_RATE_LIMITED' | 'BUFFERED' | 'RATE_LIMIT_EXCEEDED' | 'SERVICE_UNAVAILABLE' | 'SEND_MMS_AS_SMS' | 'REQUEUED_RECOVERABLE_ERROR' | 'SEND_WITH_ADDITIONAL_SPID' | 'UNSENT_FREE_TRIAL' | 'PAUSED'
- `carrier` string
- `messageText` string

## Response `200`

successful operation

- PageDeliveryReport — ~
  - `items` DeliveryReport[] — ~
    - `messageText` string — ~
    - `fromNumber` string — ~
    - `toNumber` string — ~
    - `campaignId` integer — ~
    - `deliveryCategory` 'NO_DATA' | 'OPTED_OUT' | 'BOUNCED' | 'NO_CREDITS' | 'DELIVERED' — ~
    - `deliveryState` 'DELIVERED' | 'UNSENT_OPTED_OUT_GLOBAL' | 'UNSENT_OPTED_OUT_LOCAL' | 'UNSENT_NO_CREDITS' | 'GATEWAY_REJECTED' | 'CARRIER_REJECTED' | 'NOT_DELIVERED' | 'UNSENT_INVALID_NUMBER' | 'UNSENT_BAD_DATA' | 'UNSENT_FORCE_STOPPED' | 'UNSENT_PERIOD_LIMIT' | 'UNSENT_INTERNATIONAL' | 'UNSENT_INVALID_TIMEZONE_OR_DNC' | 'UNSENT_ALREADY_SCRUBBED' | 'UNSENT_SYSTEM_ERROR' | 'UNSENT_NO_WIRELESS_CARRIER' | 'UNSENT_MESSAGE_TOO_LONG' | 'UNSENT_MESSAGE_BLOCKED' | 'UNSENT_NON_A2P_BLOCKED' | 'UNSENT_A2P_NOT_ENABLED_BLOCKED' | 'UNSENT_QUEUE_LIMIT_REACHED' | 'UNSENT_TOKEN_LIMIT_REACHED' | 'UNSENT_TIME_LIMIT_REACHED' | 'UNSENT_SCHEDULER_CAPACITY_EXCEEDED' | 'SPAM_DETECTED' | 'UNSENT_NO_GATEWAY' | 'UNSENT_DAILY_LIMIT_REACHED' | 'ORIGINATED' | 'SUBMITTED' | 'FORWARDED' | 'NOT_GIVEN' | 'UNKNOWN' | 'RETRY_MMS_AS_SMS' | 'QUEUED' | 'QUEUED_TRANSCODE' | 'ORIGINAL' | 'DUPE' | 'CONNECTOR_SELECTED' | 'TRUNCATED' | 'REQUEUED_RATE_LIMITED' | 'BUFFERED' | 'RATE_LIMIT_EXCEEDED' | 'SERVICE_UNAVAILABLE' | 'SEND_MMS_AS_SMS' | 'REQUEUED_RECOVERABLE_ERROR' | 'SEND_WITH_ADDITIONAL_SPID' | 'UNSENT_FREE_TRIAL' | 'PAUSED' — ~
    - `carrier` string — ~
    - `updated` string, date-time — ~
  - `limit` integer — ~
  - `offset` integer — ~
  - `totalCount` integer — ~

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/callfire/apis/callfire-api-documentation.md) · [All operations](https://skmtc.dev/callfire/apis/callfire-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/callfire/callfire-api-documentation/revisions/9f6fb501bc03/schema)