---
title: "Get DLR consolidated report"
method: GET
path: "/v1/report/dlr-consolidated-report"
tags: ["Report"]
---

# Get DLR consolidated report

`GET /v1/report/dlr-consolidated-report`

## Request

- Base URL: `https://smsapi.netcorecloud.net/BulkSms`
- URL: `https://smsapi.netcorecloud.net/BulkSms/v1/report/dlr-consolidated-report`
- Auth: API key in header `username`

Retrieves delivery receipt reports from Elasticsearch. Supports scroll-based pagination.

**Initial request:** Provide `feed_id`, `from_date`, and `to_date`. The response includes a `scroll_id` if more data is available.

**Pagination:** Pass the `scroll_id` from the previous response to fetch the next page. No other parameters are needed when scrolling.

**End of data:** When the last page is reached, `scroll_id` is omitted from the response. If scrolled past the end, `data` returns as an empty array.

**Constraints:**
- Date range must not exceed 31 days.
- `from_date` must not be after `to_date`.
- All requested `feed_id` values must belong to the authenticated user.

## Query parameters

- `feed_id` string
- `from_date` string, date
- `to_date` string, date
- `scroll_id` string
- `ent_id` integer
- `delivery_status` string
- `sender_id` string
- `mobile_number` string
- `request_id` integer

## Response `200`

DLR report data

- DLRReportResponse
  - `status` 'success' | 'failure', required
  - `message` string: Present only on failure
  - `scroll_id` string: Scroll ID for fetching the next page. Omitted when no more data is available.
  - `data` DLRReportItem[]
    - `mobile_no` string
    - `request_id` integer
    - `sender_id` string
    - `dlt_template_id` integer
    - `feed_name` string
    - `message` string
    - `operator` string
    - `circle` string
    - `requested_on` string: Timestamp when the SMS was submitted
    - `last_activity` string: Timestamp of the last delivery status update
    - `status` string: Delivery status code
    - `sms_count` integer
    - `tag` string: Message tag / campaign identifier
    - `transaction_id` integer
    - `message_type` 'Text' | 'Unicode' | 'Flash': Derived message type based on feed attributes

## Other responses

- `400`: Bad request or expired/invalid scroll_id
- `401`: Authentication failed
- `403`: User not authorized for the requested resource
- `500`: Internal server error

---

[API](https://skmtc.dev/netcorecloud/apis/sms-api.md) - [All operations](https://skmtc.dev/netcorecloud/apis/sms-api/llms.txt) - [OpenAPI document](https://skmtc.dev/netcorecloud/apis/sms-api/revisions/d61fd30be778?raw)