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`	Monetary amount with currency for subscription-related APIs.
`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. `CREATEDINITIATEDNOTIFIEDFAILEDCANCELLEDPAUSEDPDN_FAILED`
`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. `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`

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

200 OK

{
  "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"
    }
  ]
}