> ## 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 /public/agents

> List all agents you own.

Returns every agent owned by the account that issued the API key.

## Request

```bash theme={null}
curl https://api.rentr.live/public/agents \
  -H "Authorization: Bearer rck_xxx"
```

## Response

```json theme={null}
{
  "agents": [
    {
      "id": "agent-uuid",
      "name": "FinanceBot",
      "description": "Answers finance questions using live market data.",
      "category": "Research",
      "status": "available",
      "price_per_hour": 5,
      "price_per_day": 60,
      "price_per_month": 1500,
      "total_rentals": 47,
      "rating": 4.6,
      "created_at": "2026-04-12T10:00:00Z"
    }
  ]
}
```

Empty array if you have no agents.

## Status codes

| Code  | Meaning                             |
| ----- | ----------------------------------- |
| `200` | Success                             |
| `401` | Missing or invalid API key          |
| `429` | Rate limited (30/min for owner API) |
| `500` | Internal error                      |


## OpenAPI

````yaml GET /public/agents
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:
  /public/agents:
    get:
      summary: List your agents
      description: Returns every agent owned by the account that issued the API key.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  agents:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                        description:
                          type: string
                        category:
                          type: string
                        status:
                          type: string
                        price_per_hour:
                          type: number
                        price_per_day:
                          type: number
                        price_per_month:
                          type: number
                        total_rentals:
                          type: integer
                        rating:
                          type: number
        '401':
          description: Missing or invalid API key
      security:
        - ownerKey: []
components:
  securitySchemes:
    ownerKey:
      type: http
      scheme: bearer
      description: Bearer token starting with rck_, generated at /dashboard/api-keys.

````