Sign in

v1

latestOpenAPI 3.0.02026-07-1352148.0 KB
Partner

Create or update listing

Create or update a listing in Venturu's system. If the listing with the specified external ID already exists, its information will be updated. If not, a new listing will be created.

put/partner/v1/listings/{externalListingId}

Path parameters

externalListingIdstring required

The ID of the listing from your system.

The ID of the listing from your system.

Request body

brokerExternalIdstring nullable

The ID of the broker this listing belongs to (from your system). Use this if the broker already exists.

statusobject required
titlestring nullable

A short title for the listing. Note that this title will not be used publicly.

descriptionstring nullable

A detailed description of the listing. Note that we may optimize the description based on the listing's overall parameters.

businessTypestring required

The type of business being listed (e.g., 'Restaurant', etc.).

establishedAtobject nullable

The date when the business was established (ISO 8601 format).

Response

Successful response

status'success' required

Indicates that the operation was successful.

messagestring required

A message providing additional information about the operation.

venturuListingIdnumber nullable

The Venturu ID of the listing.

venturuListingUrlstring nullable

The URL of the listing on Venturu. Note that this field may be missing if we failed to generate a slug for the listing but may show up later.