# Get Presentations by Subscription ID

**Method:** `GET`

**Path:** `/ps/api/v1/public/subscriptions/{subscription_id}/presentations`

**Category:** Subscriptions - Presentations

**Authentication:** Required

## Description

Retrieves all presentations associated with a specific subscription.
Supports pagination.


## Path Parameters

- `subscription_id` (`string`) **required** — Unique identifier for the subscription.

## Query Parameters

- `size` (`string`) — Number of items per page.
- `page` (`string`) — Page number.
- `sort` (`string`) — Sort field and direction.

## Responses

- `200` — Presentations retrieved successfully.
- `400` — 

### Response Schema

- `links` (`object`) — Pagination links for navigation.
  - `first` (`object,null`)
    - `href` (`string`) — URL of the first page.

  - `self` (`object,null`)
    - `href` (`string`) — URL of the current page.

  - `next` (`object,null`)
    - `href` (`string`) — URL of the next page.

  - `last` (`object,null`)
    - `href` (`string`) — URL of the last page.


- `page` (`object`) — Page information for paginated responses.
  - `size` (`integer`) — Number of items per page.
  - `total_elements` (`integer`) — Total number of elements.
  - `total_pages` (`integer`) — Total number of pages.
  - `number` (`integer`) — Page number.

- `presentations` (`PresentationDetail[]`) — List of presentation records.
  - `subscription_id` (`string`) — Unique identifier for the subscription.
  - `presentation_id` (`string`) — Unique identifier for the presentation.
  - `due_date` (`string`) — The ISO 8601 UTC Timestamp when the payment is due.
  - `amount` (`object`) — Monetary amount with currency for subscription-related APIs.
    - `value` (`integer`) **required** — Amount in the smallest currency unit (paisa for INR). Minimum ₹1 (100), maximum ₹10 lakh (100000000).
    - `currency` (`string`) **required** — Three-letter ISO 4217 currency code.

  - `merchant_presentation_reference` (`string`) — Unique identifier of the merchant presentation reference.
  - `pdn_status` (`CREATED | INITIATED | NOTIFIED | FAILED | CANCELLED | PAUSED | PDN_FAILED`) — Pre-debit notification status. - CREATED: Pine Labs received the pre-debit notification request. - INITIATED: Pre-debit notification request sent to the Bank. - NOTIFIED: Notification delivered successfully. - FAILED: Notification delivery attempt unsuccessful. - CANCELLED: Notification stopped before completion. - PAUSED: Notification temporarily halted. - PDN_FAILED: Pre-debit notification failed after all retry attempts. 
  - `status` (`CREATED | PENDING | COMPLETED | FAILED | CANCELLED | PAUSED | PARTIALLY_REFUNDED | REFUNDED | INITIATED`) — Presentation status. - CREATED: Customer Debit request received. - PENDING: Debit request sent to Bank, awaiting response. - COMPLETED: Debit successfully received. - FAILED: Debit request unsuccessful. - CANCELLED: Cancel Subscription request received. - PAUSED: Pause subscription request received. - PARTIALLY_REFUNDED: Partial refund successful. - REFUNDED: Full refund successful. - INITIATED: Debit request initiated. 
  - `failure_count` (`integer`) — The number of times the requests to execute mandates at banks have failed.
  - `order_id` (`string`) — Unique identifier of the order created for this presentation.


### Example Response

```json
{
  "links": {
    "first": {
      "href": "https://api.pluralpay.in/api/v1/public/{resource}/?size=10&page=0&sort=id,asc"
    },
    "self": {
      "href": "https://api.pluralpay.in/api/v1/public/{resource}/?size=10&page=0&sort=id,asc"
    },
    "next": {
      "href": "https://api.pluralpay.in/api/v1/public/{resource}/?size=10&page=0&sort=id,asc"
    },
    "last": {
      "href": "https://api.pluralpay.in/api/v1/public/{resource}/?size=10&page=0&sort=id,asc"
    }
  },
  "page": {
    "size": 10,
    "total_elements": 50,
    "total_pages": 5,
    "number": 1
  },
  "presentations": [
    {
      "subscription_id": "v1-sub-250911093342-aa-v9YH7S",
      "presentation_id": "v1-bil-250911093822-aa-i37gSm",
      "due_date": "2025-09-12T18:00:00Z",
      "amount": {
        "value": 1000,
        "currency": "INR"
      },
      "merchant_presentation_reference": "z1B3pu003",
      "pdn_status": "NOTIFIED",
      "status": "PENDING",
      "failure_count": 0,
      "order_id": "v1-260210121553-aa-8Y4x1I"
    }
  ]
}
```

---

Reference: https://localhost:3000/api/subscriptions-presentations/list-presentations-by-subscription