---
title: "PDN List"
method: POST
path: "/subscription/pdn/list"
tags: ["PDN"]
---

# PDN List

`POST /subscription/pdn/list`

## Request

- Base URL: `https://services.jiopay.co.in/api`
- URL: `https://services.jiopay.co.in/api/subscription/pdn/list`
- Auth: HTTP bearer

Paginated listing/search of PDN records.

## Request body

- PDNListRequest
  - `page` integer, required: Page number.
  - `limit` integer, required: Page size.
  - `status` string: Filter, e.g. FAILED.
  - `mandate_id` integer: Filter by mandate ID.
  - `subscription_refid` string: Filter by subscription.
  - `merchant_txn_no` string: Filter by merchant txn no.
  - `from_date` string: Date range filter start (YYYY-MM-DD).
  - `to_date` string: Date range filter end (YYYY-MM-DD).
  - `search` string: Free-text search.
  - `secureHash` string: HMAC-SHA256 signature, computed client-side before sending and validated server-side (auto-generated by the caller, not a value you choose). Algorithm: remove any existing secureHash, sort the remaining top-level keys alphabetically, join String(value).trim() per key with `|`, then HMAC-SHA256 the resulting string with your client_secret, hex-encoded. A second variant used by some endpoints strips comments from the raw body first and JSON-stringifies object values instead of String()-converting them — confirm which variant applies with the JPSL integration team before implementing.

## Response `200`

OK

- PDNListResponse
  - `success` boolean
  - `total_records` integer
  - `current_page` integer
  - `total_pages` integer
  - `data` PDNListItem[]
    - `id` integer
    - `mandate_id` integer
    - `amount` string
    - `debit_date` string
    - `status` string
    - `phi_redirect_url` string, nullable
    - `phi_response_code` string
    - `phi_response_desc` string
    - `external_notification_id` string
    - `subscription_refid` string
    - `merchant_txn_no` string
    - `created_at` string
    - `updated_at` string

---

[API](https://skmtc.dev/jiopay/apis/subscription-hub.md) - [All operations](https://skmtc.dev/jiopay/apis/subscription-hub/llms.txt) - [OpenAPI document](https://skmtc.dev/jiopay/apis/subscription-hub/revisions/9da96f805941?raw)