Publish a listing
Puts the listing live on the chosen channels. Mandatory disclosures
are checked first.
post
Path Parameters
listingIdstringrequired
Identifier of the listing.
Example:lst_4d9b2e
Body
application/json
Body
application/json
channelsarray[string]required
Publication channel.
Allowed values:portalwebsitenewslettershop_window
>= 1 items
scheduled_forstring(date-time)
Optional time for a later, scheduled publication.
Response
application/json
Response
application/json
Published, or scheduled
Publication
listing_idstring
Example:lst_4d9b2e
statusstring
Lifecycle of a listing.
Allowed values:in_progresscompletedpublishedwithdrawnfailed
Example:completed
channelsarray[object]
Show Child Parameters
published_atstring(date-time)
Example:2026-08-20T09:44:03Z
post/listings/{listingId}/publish
Authentication
Path Parameters
Body
{
"channels": [
"portal",
"website",
"newsletter"
]
}
application/json
Templates
The agency’s design templates
List templates
The agency’s design templates, each with the sections it supports.
get
Response
application/json
Response
application/json
Templates
dataarray[object]
Show Child Parameters
get/templates
Authentication
application/json
Page
objectCursor-based pagination.
countinteger
Example:25
totalinteger
Example:138
next_cursorstring
Example:eyJzIjoyNX0
Example
ErrorDetail
objectfieldstring
Example:energy_certificate.final_energy_demand_kwh
reasonstring
Example:missing
Example