# Get Presentation

Use this API to get a presentation request.

## Environment

Use our UAT environment endpoint for testing and for integration utilize our production endpoint.

| Environment                    | Endpoints                                                                         |
| :----------------------------- | :-------------------------------------------------------------------------------- |
| User Acceptance Testing \[UAT] | `https://pluraluat.v2.pinepg.in/ps/api/v1/public/presentations/{presentation_id}` |
| Production \[PROD]             | `https://api.pluralpay.in/ps/api/v1/public/presentations/{presentation_id}`       |

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "subscription",
    "version": "3.0"
  },
  "servers": [
    {
      "url": "https://pluraluat.v2.pinepg.in/ps/api/v1/public"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header",
        "x-bearer-format": "bearer"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/presentations/{presentation_id}": {
      "get": {
        "summary": "Get Presentation",
        "description": "Use this API to get a presentation request.",
        "operationId": "get-presentation",
        "parameters": [
          {
            "name": "presentation_id",
            "in": "path",
            "description": "A Unique identifier for the presentation provided by the Plural.<ul><li>Maximum length: 50 characters.</ul></li>Example: `v1-pre-4405071524-aa-qlAtAf`",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "name": "Content-Type",
            "in": "header",
            "description": "The type of content included in the HTTP message body.<br><br>Possible value: `application/json`.",
            "schema": {
              "type": "string",
              "default": "application/json"
            }
          },
          {
            "name": "Authorization",
            "in": "header",
            "description": "The HTTP header where you can include your secret token for authentication.<br><br>Example: `Bearer <access_token>`<br><br>**Note**: Use the access token generated using our <a href=\"https://developer.pluralonline.com/v3.0/reference/generate-token\" target=\"_blank\">Generate Token API</a>.",
            "required": true,
            "schema": {
              "type": "string",
              "default": "Bearer"
            }
          },
          {
            "name": "Request-Timestamp",
            "in": "header",
            "description": "Use ISO 8601 UTC Timestamp, to create a timestamp when the generate token is requested.<br><br>Example: `2024-07-09T07:57:08.022Z`",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Request-ID",
            "in": "header",
            "description": "Use a global unique identifier [GUID] for the request.<ul><li>Minimum: 1 characters.</li><li>Maximum: 50 characters</ul></li>Example: `c17ce30f-f88e-4f81-ada1-c3b4909ed235`",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"subscription_id\": \"v1-sub-260210121547-aa-EBHW4A\",\n  \"presentation_id\": \"v1-bil-260210121553-aa-nuvfOq\",\n  \"due_date\": \"2026-02-10T12:15:53.687759Z\",\n  \"amount\": {\n    \"value\": 100,\n    \"currency\": \"INR\"\n  },\n  \"merchant_presentation_reference\": \"9424959449\",\n  \"pdn_status\": \"NOTIFIED\",\n  \"status\": \"COMPLETED\",\n  \"failure_count\": 0,\n  \"order_id\": \"v1-260210121553-aa-8Y4x1I\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "subscription_id": {
                      "type": "string",
                      "example": "v1-sub-260210121547-aa-EBHW4A"
                    },
                    "presentation_id": {
                      "type": "string",
                      "example": "v1-bil-260210121553-aa-nuvfOq"
                    },
                    "due_date": {
                      "type": "string",
                      "example": "2026-02-10T12:15:53.687759Z"
                    },
                    "amount": {
                      "type": "object",
                      "properties": {
                        "value": {
                          "type": "integer",
                          "example": 100,
                          "default": 0
                        },
                        "currency": {
                          "type": "string",
                          "example": "INR"
                        }
                      }
                    },
                    "merchant_presentation_reference": {
                      "type": "string",
                      "example": "9424959449"
                    },
                    "pdn_status": {
                      "type": "string",
                      "example": "NOTIFIED"
                    },
                    "status": {
                      "type": "string",
                      "example": "COMPLETED"
                    },
                    "failure_count": {
                      "type": "integer",
                      "example": 0,
                      "default": 0
                    },
                    "order_id": {
                      "type": "string",
                      "example": "v1-260210121553-aa-8Y4x1I"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "404",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"code\": \"PRESENTATION_NOT_FOUND\",\n  \"message\": \"Presentation not found\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "example": "PRESENTATION_NOT_FOUND"
                    },
                    "message": {
                      "type": "string",
                      "example": "Presentation not found"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "500",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"code\": \"INTERNAL_ERROR\",\n  \"message\": \"Internal Server Error\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "example": "INTERNAL_ERROR"
                    },
                    "message": {
                      "type": "string",
                      "example": "Internal Server Error"
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```