> ## Documentation Index
> Fetch the complete documentation index at: https://developer.kiotapay.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get STK Transaction Status

# Get STK Transaction Status API

This API retrieves the status of a single STK transaction using the provided  `requestId`.

***

## **Endpoint**

`GET /api/sandbox/v1/stk/status`

***

## **Base URL**

[`https://api.kiotapay.co`](https://api.kiotapay.co)

***

## **Query Parameters**

| Parameter   | Type     | Description                                         | Required |
| ----------- | -------- | --------------------------------------------------- | -------- |
|             |          |                                                     |          |
| `requestId` | `string` | The unique identifier for the specific transaction. | ✅        |

***

## **Request Headers**

| Key             | Value                 | Required | Description                                                        |
| --------------- | --------------------- | -------- | ------------------------------------------------------------------ |
| `Content-Type`  | `application/json`    | ✅        | Specifies that the request body is in JSON format.                 |
| `Authorization` | `Bearer <your-token>` | ✅        | API authentication token. Replace `<your-token>` with a valid JWT. |

***

## **Example Request**

### **cURL Command**

```bash
curl --location 'https://api.kiotapay.co/api/sandbox/api/v1/stk/status?requestId=43d23a1d-0476-4d49-a6eb-0a402c50d968' \
--header 'Content-Type: application/json'
```

**Sample Response**

```json
{
    "status": 200,
    "message": "Success",
    "data": {
        "requestId": "43d23a1d-0476-4d49-a6eb-0a402c50d968",
        "status": "PENDING",
        "amount": 10,
        "phoneNumber": "0745362174"
    }
}
```