Covent
Get HelpOpen in app
Docs navigation
Overview
Listings
Get ListingsCreate A New ListingGet A Single Listing And Its Current Lifecycle StateUpdate Listing FieldsDelete Or Archive A Listing From The External Api Surface. This Is Part Of The Proposed V1 Contract But Not Clearly Backed Yet
Individuals
Offers
Walkthroughs
Market intelligence
Polaris

Listings

Create A New Listing

POSThttps://api.getcovent.com/api/v1/listings

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

How to Call

Use one of the examples below to call this endpoint from your own integration.

curl -X POST "https://api.getcovent.com/api/v1/listings" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "headline": "Off-market duplex in central Phoenix",
  "status": "draft",
  "address": {
    "street": "101 W Adams St",
    "city": "Phoenix",
    "state": "AZ",
    "zip": "85003"
  },
  "pricing": {
    "asking_price": 385000,
    "assignment_fee": 15000
  },
  "property_details": {
    "property_type": "duplex",
    "bedrooms": 4,
    "bathrooms": 2,
    "square_feet": 1980
  }
}'

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/json
Content-TypestringRequired

JSON request body header.

Example: application/json

headlinestringRequired

headline request field.

Example: Off-market duplex in central Phoenix
statusstringRequired

status request field.

Example: draft
addressobjectRequired

address request field.

Example: {"street":"101 W Adams St","city":"Phoenix","state":"AZ","zip":"85003"}
pricingobjectRequired

pricing request field.

Example: {"asking_price":385000,"assignment_fee":15000}
property_detailsobjectRequired

property_details request field.

Example: {"property_type":"duplex","bedrooms":4,"bathrooms":2,"square_feet":1980}

Response

200application/json

idstringRequired

id response field.

Example: lst_123
headlinestringRequired

headline response field.

Example: Off-market duplex in central Phoenix
statusstringRequired

status response field.

Example: draft
addressobjectRequired

address response field.

Example: {"street":"101 W Adams St","city":"Phoenix","state":"AZ","zip":"85003"}
pricingobjectRequired

pricing response field.

Example: {"asking_price":385000,"assignment_fee":15000}
property_detailsobjectRequired

property_details response field.

Example: {"property_type":"duplex","bedrooms":4,"bathrooms":2,"square_feet":1980}
created_atstringRequired

created_at response field.

Example: 2026-04-17T20:00:00Z
updated_atstringRequired

updated_at response field.

Example: 2026-04-17T20:00:00Z

Response Example

{
  "id": "lst_123",
  "headline": "Off-market duplex in central Phoenix",
  "status": "draft",
  "address": {
    "street": "101 W Adams St",
    "city": "Phoenix",
    "state": "AZ",
    "zip": "85003"
  },
  "pricing": {
    "asking_price": 385000,
    "assignment_fee": 15000
  },
  "property_details": {
    "property_type": "duplex",
    "bedrooms": 4,
    "bathrooms": 2,
    "square_feet": 1980
  },
  "created_at": "2026-04-17T20:00:00Z",
  "updated_at": "2026-04-17T20:00:00Z"
}