---
title: "List inquiries"
url: "https://real-estate-agency.apim.eu/apis/leads/versions/d1fa19e4-3a7d-4b6b-aac0-9ec016571b4b/operations/listInquiries"
---

> Full API specification: https://real-estate-agency.apim.eu/apis/leads/versions/d1fa19e4-3a7d-4b6b-aac0-9ec016571b4b.md

# List inquiries

`GET` `/inquiries`

Operation ID: `listInquiries`

## Query parameters

- `property_id` (string, optional)
- `status` (string, optional)

## Responses

- `200` - Results list

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Leads & Inquiries
  version: 1.0.0
servers:
  - url: https://api.realestateagency.example/v1
    description: Production
  - url: https://sandbox.api.realestateagency.example/v1
    description: Sandbox
paths:
  /inquiries:
    get:
      tags:
        - Inquiries
      summary: List inquiries
      operationId: listInquiries
      parameters:
        - name: property_id
          in: query
          schema:
            type: string
            example: prop_8f2c1a
        - name: status
          in: query
          schema:
            $ref: "#/components/schemas/InquiryStatus"
      responses:
        "200":
          description: Results list
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: "#/components/schemas/Inquiry"
                  page:
                    $ref: "#/components/schemas/Page"
security:
  - apiKey: []
components:
  schemas:
    InquiryStatus:
      type: string
      enum:
        - new
        - scored
        - invited
        - declined
        - closed
      example: scored
    Inquiry:
      type: object
      properties:
        id:
          type: string
          example: inq_5c02
        property_id:
          type: string
          example: prop_8f2c1a
        lead_id:
          type: string
          example: lead_71ab
        status:
          $ref: "#/components/schemas/InquiryStatus"
        channel:
          type: string
          example: website
        message:
          type: string
          example: Hello, is the apartment still available? We would like to view it.
        received_at:
          type: string
          format: date-time
          example: 2026-08-19T17:05:31Z
    Page:
      type: object
      description: Cursor-based pagination.
      properties:
        count:
          type: integer
          example: 25
        total:
          type: integer
          example: 138
        next_cursor:
          type: string
          nullable: true
          example: eyJzIjoyNX0
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: apikey
      description: |
        Every call carries an API key in the `apikey` header. You generate the
        key in the Real Estate portal under "My Apps"; it's shown exactly once.

        Each key has the scopes it's allowed to use attached to it. If one is
        missing, the API responds with `403` and `code: "scope_missing"`; the
        missing scope is in `details[].field`.
```