> ## 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 Paybill Transaction Status

# Paybill Transaction Status API

This API retrieves the status of a specific Paybill transaction based on the `requestId`.

***

## **Endpoint**

`GET /api/sandbox/v1/paybill/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 theme={null}
curl --location --request GET 'https://api.kiotapay.co/api/sandbox/v1/paybill/status?requestId=4f88dd2e-c4b4-4a3f-9605-1679686a6641' \
--header 'Content-Type: application/json'
```

**Sample Body**

```json theme={null}
{
    "status": 200,
    "message": "Success",
    "data": {
        "accountNumber": "22442244",
        "businessNumber": "2232334",
        "requestId": "4f88dd2e-c4b4-4a3f-9605-1679686a6641",
        "amount": 1000.0,
        "status": "PENDING"
    }
}
```