List Presentations by Subscription

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

Field	Details
`subscription_id` `string`required	Unique identifier for the subscription. Constraints Maximum length: 50 characters

Header Parameters

Field	Details
`Request-Timestamp` `string`date-time	ISO 8601 UTC timestamp of the request. Used for idempotency and audit.
`Request-ID` `string`	Use a global unique identifier [GUID] for the request. Constraints Minimum length: 1 characterMaximum length: 50 characters

Query Parameters

Field	Details
`size` `string`	Number of items per page.
`page` `string`	Page number.
`sort` `string`	Sort field and direction.

Response

Field	Details
`links` `object`4 nested fields	Pagination links for navigation.
`first` `object`nullable1 nested field
`self` `object`nullable1 nested field
`next` `object`nullable1 nested field
`last` `object`nullable1 nested field
`page` `object`4 nested fields	Page information for paginated responses.
`presentations` `PresentationDetail[]`9 nested fields	List of presentation records.

Status Codes

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

Run

Request

curl --request GET \
  --url 'https://pluraluat.v2.pinepg.in/ps/api/v1/public/subscriptions/v1-sub-250916121532-aa-lKR1S1/presentations?size=10&page=1&sort=cycleId%2Cdesc' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Request-ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
  --header 'Request-Timestamp: 2024-10-01T10:30:00Z'

Status:

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