---
title: "Get POI status"
method: GET
path: "/api/poi/{poiId}/status"
tags: ["POI"]
---

# Get POI status

`GET /api/poi/{poiId}/status`

## Request

- Base URL: `https://api.payware.eu`
- URL: `https://api.payware.eu/api/poi/{poiId}/status`
- Auth: HTTP bearer

Retrieves the current status of a POI including any pending payment. A POI returns to IDLE as soon as it is scanned, so pass the sessionToken returned by the price push to also get the transaction created for that session and its current status (transactionId, transactionStatus). Keep the session token until the status is final: CONFIRMED, DECLINED, FAILED, CANCELLED or EXPIRED. The fields are empty until the POI is scanned, and for a token that does not belong to this POI.

## Path parameters

- `poiId` string, required

## Query parameters

- `sessionToken` string

## Response `200`

POI status retrieved successfully

## Other responses

- `401`: Unauthenticated - missing, malformed or expired credentials
- `403`: Forbidden - the caller is authenticated but not permitted (plan or capability gate, KYC state, or tenant scope)
- `404`: POI not found
- `429`: Too many requests - the caller exceeded its per-partner rate limit. Carries errorCode ERR_RATE_LIMIT_EXCEEDED and a Retry-After header, in seconds. The request was not processed, so the identical request is safe to retry once the window has passed.

---

[API](https://skmtc.dev/payware/apis/payware-api.md) · [All operations](https://skmtc.dev/payware/apis/payware-api/llms.txt) · [OpenAPI document](https://skmtc.dev/payware/apis/payware-api/revisions/7b3352ca947b?raw)