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

# Till Status API

> Endpoint to fetch the status of a till transaction using the `requestId` .

# Till Status API

This API allows a company to fetch the status of a specific till transaction using the  `requestId`.

## Endpoint

GET /api/sandbox/v1/till/status

### Base URL

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

## Query Parameters

| Parameter | Type | Description | Required |
| - | - | - | - |
| ✅ | | | |
| `requestId` | `string` | The unique ID of the request for which the status is being checked. | ✅ |

## **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. |

## Interactive API

## Example Curl Request

```bash theme={null}
curl --location 'https://api.kiotapay.co/api/sandbox/v1/auth/spending/till/status?companyId=4d6e1ea9-5ab8-496a-978f-7e9b2bce80c4&requestId=20f6da4c-f1fa-4af0-9e5c-72c4e7ac8f57'
```

**Sample Response**

```json theme={null}
{
    "status": 201,
    "message": "Success",
    "data": {
        "accountNumber": "435567676",
        "businessNumber": "12345",
        "requestId": "20f6da4c-f1fa-4af0-9e5c-72c4e7ac8f57",
        "amount": 1000.0,
        "status": "PENDING"
    }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.