Sharetribe icon

Sharetribe

Allows interaction with the Sharetribe Integration API

Listing → Get

AI-generated

Summary

Retrieve a single Sharetribe listing by ID

Inputs

  • listingId (required) — The UUID of the listing to retrieve
  • simplify — When true, returns a simplified version of the response with fewer fields
  • listingFields — List of field names to include in the response; defaults to ["createdAt","listingType","price","state","title"]
  • authorFields — Fields to return for the author when listingFields contains "author"; defaults to ["firstName","lastName","email"]

Output shape

a single listing object

If simplify is true, only the selected fields are included; otherwise the full listing object is returned. Optional fields may be omitted.

Examples

Example 1: Fetch a listing with basic fields

listingId: 550e8400-e29b-41d4-a716-446655440000, simplify: true, listingFields: ["createdAt","price","title"]

Example 2: Fetch a listing with extended author data

listingId: 550e8400-e29b-41d4-a716-446655440000, simplify: false, listingFields: ["author"], authorFields: ["firstName","lastName","email"]

Links

Discussion