> ## Documentation Index
> Fetch the complete documentation index at: https://rideshare.docs.sumit-dhondikar.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Session Status

> Retrieve the status of a payment session by session ID.

Fetch the current status and details of a payment session. Use this endpoint to poll or confirm the outcome of a payment after checkout.

**No authentication required** — this is a public endpoint.

## Request

**`GET /payments/session/{sessionId}`**

### Path Parameters

<ParamField path="sessionId" type="string" required>
  The unique identifier of the payment session to retrieve.
</ParamField>

## Response

<ResponseField name="sessionId" type="string">
  The session identifier.
</ResponseField>

<ResponseField name="status" type="string">
  The current status of the payment session (e.g. `pending`, `completed`, `failed`).
</ResponseField>

<ResponseField name="amount" type="integer">
  The session amount in paise.
</ResponseField>

<ResponseField name="currency" type="string">
  The currency for this session. Always `INR`.
</ResponseField>

<ResponseField name="paymentMode" type="string">
  The payment mode associated with this session.
</ResponseField>

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET http://localhost:8080/payments/session/sess_OmXy5678efgh
  ```

  ```json Response theme={null}
  {
    "sessionId": "sess_OmXy5678efgh",
    "status": "completed",
    "amount": 25000,
    "currency": "INR",
    "paymentMode": "upi"
  }
  ```
</CodeGroup>