Resource group

Listings

Manage property listings in Covent. This surface covers listing creation, retrieval, updates, deletion, and core lifecycle data such as pricing, status, and property details.

Endpoint Reference

Open a specific endpoint to see SDK call examples, request parameters, and response details.

GET

Get Listings

View Endpoint

/api/v1/listings

Retrieve listings with optional filtering, sorting, and pagination.

POST

Create A New Listing

View Endpoint

/api/v1/listings

Create a new listing with pricing, property details, and initial status.

GET

Get A Single Listing And Its Current Lifecycle State

View Endpoint

/api/v1/listings/{id}

Retrieve a single listing and its current lifecycle state.

PATCH

Update Listing Fields

View Endpoint

/api/v1/listings/{id}

Update listing fields such as status, pricing, or property details.

DELETE

Delete Or Archive A Listing From The External Api Surface. This Is Part Of The Proposed V1 Contract But Not Clearly Backed Yet

View Endpoint

/api/v1/listings/{id}

Delete or archive a listing from the external API surface. This is part of the proposed V1 contract but not clearly backed yet.