get/v1/directory/listings
Public global-directory listing read. Only GLOBAL/BOTH-visibility listings ever appear here — PRIVATE and ENTERPRISE never do. See docs/business/glossary.md "Global vs Private vs Both vs Enterprise".
Parameters
| category | query | optional |
| | optional |
| | optional |
Response (200)
| Field | Type | Required |
|---|
| data | object[] | — |
| nextCursor | stringnull | — |
get/v1/directory/listings/{id}
Get a single listing from the public global directory
Response (200)
| Field | Type | Required |
|---|
| id | string (uuid) | — |
| merchantId | string,null (uuid) | — |
| merchantListingRef | stringnull | — |
| sellerId | string (uuid) | — |
| title | string | — |
| category | string | — |
| subcategory | stringnull | — |
| brand | stringnull | — |
| model | stringnull | — |
| size | stringnull | — |
| condition | stringnull | — |
| year | integernull | — |
| originalPrice | number | — |
| currency | string | — |
| visibility | PRIVATE | GLOBAL | BOTH | ENTERPRISE | — |
| status | ACTIVE | RESERVED | SOLD | UNAVAILABLE | DELETED | — |
| listingType | SALE | TRADE | BOTH | — |
| deliveryMethod | LOCAL_PICKUP | SHIPPING | BOTH | | — |
| preferredSpaceBranchId | string,null (uuid) | — |
| merchantItemUrl | string,null (uri) | — |
| requestedAmount | numbernull | — |
| willingToPay | numbernull | — |
| note | stringnull | — |
| images | string[] | — |
| wants | object[] | — |
| createdAt | string (date-time) | — |
| updatedAt | string (date-time) | — |
| syncedAt | string (date-time) | — |
| deletedAt | string,null (date-time) | — |