Listing Creation

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
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

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

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

Templates

dataarray[object]
Show Child Parameters
get/templates
 
application/json

Page

object

Cursor-based pagination.

countinteger

Example:25

totalinteger

Example:138

next_cursorstring

Example:eyJzIjoyNX0

Example

ErrorDetail

object
fieldstring

Example:energy_certificate.final_energy_demand_kwh

reasonstring

Example:missing

Example