Get Listings
GET
https://api.getcovent.com/api/v1/listings?status=active&market=phoenix-az&page=1&page_size=25&sort=updated_at%3AdescRetrieve listings with optional filtering, sorting, and pagination.
How to Call
Use one of the examples below to call this endpoint from your own integration.
curl -X GET "https://api.getcovent.com/api/v1/listings?status=active&market=phoenix-az&page=1&page_size=25&sort=updated_at%3Adesc" \
-H "Authorization: Bearer <API_KEY>" \
-H "Accept: application/json"Request
Review headers, parameters, and body fields before calling this endpoint.
AuthorizationstringRequired
Bearer token for the proposed external API contract.
Example: Bearer <API_KEY>AcceptstringRequired
Response format header.
Example: application/jsonstatusstringRequired
status query parameter.
Example: activemarketstringRequired
market query parameter.
Example: phoenix-azpagenumberRequired
page query parameter.
Example: 1page_sizenumberRequired
page_size query parameter.
Example: 25sortstringRequired
sort query parameter.
Example: updated_at:descResponse
200application/jsonitemsarrayRequired
items response field.
Example: [{"id":"lst_123","headline":"Off-market duplex in central Phoenix","status":"active","pricing":{"asking_price":385000,"assignment_fee":15000},"address":{"city":"Phoenix","state":"AZ"}}]pagenumberRequired
page response field.
Example: 1page_sizenumberRequired
page_size response field.
Example: 25totalnumberRequired
total response field.
Example: 182Response Example
{
"items": [
{
"id": "lst_123",
"headline": "Off-market duplex in central Phoenix",
"status": "active",
"pricing": {
"asking_price": 385000,
"assignment_fee": 15000
},
"address": {
"city": "Phoenix",
"state": "AZ"
}
}
],
"page": 1,
"page_size": 25,
"total": 182
}