List Subscription Plans

GET/ps/api/v1/public/plans

Retrieves all subscription plans. Supports filtering by plan_id, date range, amount, frequency, and pagination.

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

Requires Bearer token. Get token →

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
`plan_id` `string`	Filter by plan ID.
`start_date` `string`date-time	Filter plans with start date after this value (ISO 8601 UTC).
`end_date` `string`date-time	Filter plans with end date before this value (ISO 8601 UTC).
`amount` `integer`	Filter by amount value.
`amount_range` `string`	Amount comparison operator. Allowed values: `isMoreisLessis Equal`
`frequency` `string`	Filter by billing frequency.
`size` `integer`	Number of items per page.
`page` `integer`	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.
`plans` `PlanResponse[]`16 nested fields	List of plan records.

Status Codes

`200`	Plans retrieved successfully.
`500`	An unexpected error occurred on the server.

Run

Request

curl --request GET \
  --url 'https://pluraluat.v2.pinepg.in/ps/api/v1/public/plans?plan_id=v1-plan-4405071524-aa-qlAtAf&start_date=2022-02-01T17%3A32%3A28Z&end_date=2026-10-21T12%3A02%3A28Z&amount=100&amount_range=isMore&frequency=Month&size=10&page=0&sort=id%2Casc' \
  --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": {
      "href": "https://api.pluralpay.in/api/v1/public/plans/?size=10&page=0&sort=id,asc"
    },
    "self": {
      "href": "https://api.pluralpay.in/api/v1/public/plans/?size=10&page=0&sort=id,asc"
    },
    "next": {
      "href": "https://api.pluralpay.in/api/v1/public/plans/?size=10&page=0&sort=id,asc"
    },
    "last": {
      "href": "https://api.pluralpay.in/api/v1/public/plans/?size=10&page=0&sort=id,asc"
    }
  },
  "page": {
    "size": 10,
    "total_elements": 50,
    "total_pages": 5,
    "number": 1
  },
  "plans": [
    {
      "plan_id": "v1-plan-4405071524-aa-qlAtAf",
      "status": "ACTIVE",
      "plan_name": "Monthly Plan",
      "plan_description": "Diwali dhammaka plan intended to attract customers on diwali time",
      "frequency": "Day",
      "amount": {
        "value": 100,
        "currency": "INR"
      },
      "max_limit_amount": {
        "value": 100,
        "currency": "INR"
      },
      "trial_period_in_days": 1,
      "start_date": "2022-02-01T17:32:28Z",
      "end_date": "2022-10-21T17:32:28Z",
      "merchant_metadata": {
        "key1": "DD",
        "key2": "XOF"
      },
      "merchant_plan_reference": "1234567890",
      "created_at": "2022-10-21T17:32:28Z",
      "modified_at": "2022-10-21T17:32:28Z"
    }
  ]
}