Marketplace

Get Seller Listings

List all marketplace listings owned by your account.

Retrieve your listings with sales totals and pricing. Use pagination parameters for accounts with many listings.

Important: This returns only your own listings. There is no public listing directory — buyers can only access listings through direct links or email invites you share with them.

Authentication Required: Valid API key or JWT token

Query Parameters:

  • limit: Max results to return (default 50)
  • offset: Number of results to skip for pagination (default 0)

Status Codes:

  • 200: Listings returned (empty array if none)
get/v1/marketplace/listings

Request

  • Base URL: https://api.lumethic.com
  • URL: https://api.lumethic.com/v1/marketplace/listings
  • Auth: OAuth2PasswordBearer (a scheme the document does not define)

Query parameters

limitinteger

Maximum number of results to return

offsetinteger

Number of results to skip for pagination

Headers

X-API-Keystring nullable

Response

Seller listings 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.