Get Presentations by Subscription ID

GET/ps/api/v1/public/subscriptions/{subscription_id}/presentations

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

View as Markdown Open in ChatGPT Open in Claude Open in Perplexity

Requires Bearer token. Get token →

Path Parameters

Name	Type	Description
`subscription_id`	`string`required	Unique identifier for the subscription.

Query Parameters

Name	Type	Description
`size`	`string`	Number of items per page.
`page`	`string`	Page number.
`sort`	`string`	Sort field and direction.

Response

Name	Type	Description
`links`	`object`	Pagination links for navigation.
`first`	`objectnull`
`self`	`objectnull`
`next`	`objectnull`
`last`	`objectnull`
`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`	This is the recurring mandate amount, that would be charged for each frequency. For instance 200 every month. This field is not needed if the mandate frequency is AS
`merchant_presentation_reference`	`string`	Unique identifier of the merchant presentation reference.
`pdn_status`	`string`	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. Allowed values: `CREATEDINITIATEDNOTIFIEDFAILEDCANCELLEDPAUSEDPDN_FAILED`
`status`	`string`	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. Allowed values: `CREATEDPENDINGCOMPLETEDFAILEDCANCELLEDPAUSEDPARTIALLY_REFUNDEDREFUNDEDINITIATED`
`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.

Status Codes

`200`	Presentations retrieved successfully.
`400`	The request was malformed or missing required fields.

Request

curl --request GET \
  --url https://pluraluat.v2.pinepg.in/ps/api/v1/public/subscriptions/%7Bsubscription_id%7D/presentations \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Run this request

Bearer token

Path parameters

subscription_id

Query parameters

size

page

sort

Status:

200 OK

{
  "links": {
    "first": null,
    "self": {
      "href": "http://plural-subscription-service-uat.v2.pinepg.in/api/v1/public/subscriptions/v1-sub-250916121532-aa-lKR1S1/presentations?size=10&page=1&sort=cycleId%2Cdesc"
    },
    "next": null,
    "last": null
  },
  "page": {
    "size": 10,
    "total_elements": 4,
    "total_pages": 1,
    "number": 0
  },
  "presentations": [
    {
      "subscription_id": "v1-sub-250916121532-aa-lKR1S1",
      "presentation_id": "v1-bil-250916130526-aa-nBELDX",
      "due_date": "2025-09-20T10:00:00Z",
      "amount": {
        "value": 100,
        "currency": "INR"
      },
      "merchant_presentation_reference": "z1B3pu0916002",
      "pdn_status": "NOTIFIED",
      "status": "INITIATED",
      "failure_count": 0
    },
    {
      "subscription_id": "v1-sub-250916121532-aa-lKR1S1",
      "presentation_id": "v1-bil-250916122333-aa-lDQHQ1",
      "due_date": "2025-09-19T10:00:00Z",
      "amount": {
        "value": 100,
        "currency": "INR"
      },
      "merchant_presentation_reference": "z1B3pu0916001",
      "pdn_status": "NOTIFIED",
      "status": "COMPLETED",
      "failure_count": 0
    }
  ]
}