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

# List Properties

Use this endpoint to list properties with pagination.

<ParamField query="limit" type="integer" default="50">
  Max results to return (1-200).
</ParamField>

<ParamField query="cursor" type="string">
  Pagination cursor from a previous response.
</ParamField>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": [
      {
        "id": "prop_123",
        "name": "Lakeside Apartments",
        "address": "123 Lake St",
        "units": 120
      }
    ],
    "next_cursor": null
  }
  ```
</ResponseExample>


## OpenAPI

````yaml GET /api/v1/properties
openapi: 3.1.0
info:
  title: CasaAI API
  description: >-
    APIs for properties, tenants, maintenance, workflows, agents, finance, and
    documents.
  version: 1.0.0
servers:
  - url: https://api.casaai.dev
security:
  - bearerAuth: []
paths:
  /api/v1/properties:
    get:
      summary: List properties
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
            format: int32
            default: 50
          description: Max results to return
        - name: cursor
          in: query
          schema:
            type: string
          description: Cursor for pagination
      responses:
        '200':
          description: List of properties
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Property'
                  next_cursor:
                    type: string
                    nullable: true
components:
  schemas:
    Property:
      type: object
      required:
        - id
        - name
      properties:
        id:
          type: string
        name:
          type: string
        address:
          type: string
        units:
          type: integer
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````