---
title: "Search listings"
method: GET
path: "/listings"
tags: ["Listings"]
---

# Search listings

`GET /listings`

## Request

- Base URL: `https://tulugar.com/api/v1`
- URL: `https://tulugar.com/api/v1/listings`
- Auth: none declared

## Query parameters

- `listing_type` string
- `property_type` string
- `min_price` number
- `max_price` number
- `currency` string
- `bedrooms` integer
- `bathrooms` integer
- `min_area` number
- `max_area` number
- `city` string
- `neighborhood` string
- `country` string
- `agent_id` string
- `company_id` string
- `verified_only` boolean
- `sort` string
- `locale` string
- `fields` string
- `q` string
- `building` string
- `amenities` string
- `limit` integer
- `offset` integer

## Response `200`

Paginated list

- object
  - `data` Listing[]
    - `id` string, uuid
    - `slug` string
    - `title` string
    - `price` number
    - `currency` 'USD' | 'PYG' | 'BRL' | 'ARS' | 'UYU'
    - `listing_type` 'sale' | 'rent'
    - `property_type` string
    - `bedrooms` integer, nullable
    - `bathrooms` integer, nullable
    - `area_sqm` number, nullable
    - `city` string
    - `neighborhood` string, nullable
    - `country` string
    - `images` string[]
    - `latitude` number, nullable
    - `longitude` number, nullable
    - `created_at` string, date-time
    - `agent` object: Included in detail view only
      - `id` string, uuid
      - `name` string
      - `slug` string
      - `avatar_url` string, nullable
      - `verified` boolean
      - `rating` number, nullable
  - `pagination` Pagination
    - `total` integer
    - `limit` integer
    - `offset` integer
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time

## Other responses

- `429`: Rate limited
- `500`: Server error

---

[API](https://skmtc.dev/tulugar/apis/tu-lugar-api.md) · [All operations](https://skmtc.dev/tulugar/apis/tu-lugar-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tulugar/apis/tu-lugar-api/revisions/868219e90320?raw)