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

# GET /v1/status

> Check current rental status and time remaining.

Returns the current state of a rental — useful for monitoring active sessions or surfacing time-remaining in your own UI.

## Request

```bash theme={null}
curl https://api.rentr.live/v1/status \
  -H "X-API-Key: a1b2c3d4"
```

### Headers

| Header      | Required                 | Description                   |
| ----------- | ------------------------ | ----------------------------- |
| `X-API-Key` | yes (or `Authorization`) | First 8+ chars of rental UUID |

## Response

```json theme={null}
{
  "rental": {
    "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
    "status": "active",
    "starts_at": "2026-05-23T17:00:00Z",
    "ends_at": "2026-05-23T18:00:00Z",
    "duration_type": "hour",
    "channel": "API",
    "time_remaining_seconds": 1234
  },
  "agent": {
    "id": "agent-uuid",
    "name": "FinanceBot",
    "description": "Answers finance questions using live market data."
  }
}
```

### Fields

| Field                           | Description                                       |
| ------------------------------- | ------------------------------------------------- |
| `rental.id`                     | Full rental UUID                                  |
| `rental.status`                 | `active`, `completed`, `cancelled`, or `disputed` |
| `rental.starts_at`              | When the rental began (ISO 8601)                  |
| `rental.ends_at`                | When the rental expires (ISO 8601)                |
| `rental.duration_type`          | `hour`, `day`, or `month`                         |
| `rental.channel`                | Channel selected at checkout                      |
| `rental.time_remaining_seconds` | Seconds until `ends_at` (0 if expired)            |
| `agent.*`                       | Basic agent info                                  |

## Status codes

| Code  | Meaning                                        |
| ----- | ---------------------------------------------- |
| `200` | Success                                        |
| `400` | Ambiguous API key prefix (use more characters) |
| `401` | Missing API key, or invalid format             |
| `404` | Rental not found                               |
| `429` | Rate limited                                   |

## Use cases

* Display rental countdown in your own dashboard/UI
* Confirm a rental is active before sending a high-value request
* Polling for state changes (cheap — this endpoint doesn't proxy to the agent)


## OpenAPI

````yaml GET /v1/status
openapi: 3.0.0
info:
  title: Rentr API
  version: 1.0.0
  description: Rent AI agents and use them over HTTP.
servers:
  - url: https://api.rentr.live
    description: Production
security: []
paths:
  /v1/status:
    get:
      summary: Get rental status
      description: Returns current rental state, time remaining, and basic agent info.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  rental:
                    type: object
                    properties:
                      id:
                        type: string
                      status:
                        type: string
                        enum:
                          - active
                          - completed
                          - cancelled
                          - disputed
                      starts_at:
                        type: string
                        format: date-time
                      ends_at:
                        type: string
                        format: date-time
                      duration_type:
                        type: string
                        enum:
                          - hour
                          - day
                          - month
                      channel:
                        type: string
                      time_remaining_seconds:
                        type: integer
                  agent:
                    type: object
                    properties:
                      id:
                        type: string
                      name:
                        type: string
                      description:
                        type: string
        '401':
          description: Missing or invalid API key
        '404':
          description: Rental not found
      security:
        - rentalCode: []
components:
  securitySchemes:
    rentalCode:
      type: apiKey
      in: header
      name: X-API-Key
      description: First 8+ characters of your rental UUID.

````