Marketplace

Get Listing

Get a marketplace listing by ID.

Retrieve listing details including pricing, license terms, and sales totals. This endpoint does not require authentication, but the caller must know the listing UUID — there is no public directory or search for listings. Sellers share listing URLs directly with potential buyers via link or email invite.

Authentication: Not required (public endpoint, but listing ID must be known)

Path Parameters:

  • listing_id: UUID of the listing

Status Codes:

  • 200: Listing returned
  • 404: Listing not found
get/v1/marketplace/listings/{listing_id}

Request

  • Base URL: https://api.lumethic.com
  • URL: https://api.lumethic.com/v1/marketplace/listings/{listing_id}
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

listing_idstring uuid required

Response

Listing returned

idstring uuid required

Unique identifier for the listing

verification_idstring uuid required

ID of the verified photo this listing represents

titlestring required

Display title for the listing

descriptionstring nullable required

Optional description of the photo and its context

is_activeboolean required

Whether the listing is currently available for purchase

currencystring required

ISO 4217 currency code (e.g., 'usd', 'eur', 'chf')

price_personal_centsinteger nullable required

Price in cents for personal use license

price_commercial_centsinteger nullable required

Price in cents for commercial use license

price_editorial_centsinteger nullable required

Price in cents for editorial use license

price_extended_centsinteger nullable required

Price in cents for extended/unlimited use license

license_terms_personalstring nullable required

Terms and restrictions for personal use

license_terms_commercialstring nullable required

Terms and restrictions for commercial use

license_terms_editorialstring nullable required

Terms and restrictions for editorial use

license_terms_extendedstring nullable required

Terms and restrictions for extended use

total_salesinteger required

Total number of licenses sold for this listing

total_revenue_centsinteger required

Total revenue generated in cents

created_atstring required

ISO 8601 timestamp when the listing was created

updated_atstring required

ISO 8601 timestamp when the listing was last modified

Changes

No recorded changes to this operation across all 1 revision of this API.