Actions28
- Asset Actions
- Availability Exception Actions
- Event Actions
- Image Actions
- Listing Actions
- Marketplace Actions
- Stock Actions
- Transaction Actions
- User Actions
Listing → Get
AI-generatedSummary
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"]