Marketplace

Create Listing

Create a marketplace listing for a verified photo.

Turn a verified photo into a licensable listing that buyers can purchase. Each listing is tied to a single verification and supports multiple license types (personal, commercial, editorial, extended) with independent pricing.

Important: There is no public browsing or discovery of listings. Listings are only accessible to buyers who receive a direct link or email invite from the seller. Share your listing URL or use the verification sharing features to make it available.

Authentication Required: Valid API key or JWT token

Query Parameters:

  • verification_id: UUID of the verification to create a listing for

Request Body: Listing details including title, description, currency, prices per license type (in cents), and license terms for each type.

Restrictions:

  • Verification must belong to your account
  • Anonymous verifications cannot create listings (register for a free account first)
  • At least one license type price must be set

Status Codes:

  • 201: Listing created successfully
  • 402: Insufficient permissions (plan upgrade required)
  • 403: Anonymous verification — register to unlock marketplace
  • 404: Verification not found
post/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

verification_idstring uuid required

Headers

X-API-Keystring nullable

Request body

titlestring required
descriptionstring nullable
currency'usd' | 'cad' | 'mxn' | 'eur' | 'gbp' | 'chf' | 'sek' | 'nok' | 'dkk' | 'pln' | 'czk' | 'huf' | 'ron' | 'bgn' | 'aud' | 'nzd' | 'jpy' | 'sgd' | 'hkd' | 'krw' | 'cny' | 'inr' | 'thb' | 'myr' | 'brl' | 'aed' | 'zar' | 'ils'

Supported currencies for marketplace listings and purchases.

Focus on major currencies for EU, US, Australia, and Canada regions, plus other commonly used currencies in photography markets.

price_personal_centsinteger nullable
price_commercial_centsinteger nullable
price_editorial_centsinteger nullable
price_extended_centsinteger nullable
license_terms_personalstring nullable
license_terms_commercialstring nullable
license_terms_editorialstring nullable
license_terms_extendedstring nullable

Example request

{
  "currency": "usd",
  "description": "Authenticated landscape photo taken with Nikon Z9",
  "license_terms_commercial": "Commercial use in marketing materials",
  "license_terms_editorial": "Editorial use in news and publications",
  "license_terms_extended": "Unlimited commercial use including merchandise",
  "license_terms_personal": "Personal use only, no redistribution",
  "price_commercial_cents": 5000,
  "price_editorial_cents": 2000,
  "price_extended_cents": 10000,
  "price_personal_cents": 1000,
  "title": "Sunset over Lake Zurich"
}

Response

Listing created successfully

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.