---
title: "List all property listing statuses"
method: GET
path: "/listing_statuses"
tags: ["ListingStatuses"]
---

# List all property listing statuses

`GET /listing_statuses`

Returns a list of property listing statuses from your organization.
                         If you have an MLS API plan, you can also get your collaborators' listing statuses for all their published properties and the properties unpublished in the last month.

## Query parameters

- `page` integer
- `limit` integer
- `search` ListingStatusSearchParams — Optional search parameters.
  - `updated_after` string, date-time — Retrieve listing statuses for properties updated after the given time.
  - `updated_before` string, date-time — Retrieve listing statuses for properties updated before the given time.
- `search[statuses][]` string[]
- `search[include_collaborator_listings]` boolean
- `search[agency_id]` integer

## Response `200`

Successful listing status list request.

- ListingStatusList
  - `pagination` Pagination
    - `limit` integer, required
    - `page` integer, required
    - `total` integer
    - `next_page` string, required
  - `content` ListingStatus[]
    - `public_id` string
    - `status` 'published' | 'sold' | 'rented' | 'reserved' | 'suspended' | 'not_published' — The listing status.
    - `updated_at` string, date-time — The last time the property was updated.

## Other responses

- `400` — At least one search param has an invalid format.
- `401` — API key is missing or invalid, or a restricted country was selected

---

[API](https://skmtc.dev/easybroker/apis/easybroker-api.md) · [All operations](https://skmtc.dev/easybroker/apis/easybroker-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/easybroker/easybroker-api/revisions/1aea2ecce635/schema)
