Developers · Launching soon

    The Lumistate API

    Enhance, stage and process real-estate photos at scale - straight from your portal, MLS or CRM. One async REST endpoint, the same pipeline that powers Lumistate, returned by webhook. Full documentation is on the way.

    01
    Authenticate
    Bearer API key
    02
    Submit a job
    photo + intent
    03
    We enhance async
    queue + AI worker
    04
    Receive result
    webhook or poll

    A taste of the docs

    One call to enhance a photo

    Submit a job with an image and an intent. Lumistate resolves billing, runs the enhancement on its worker pipeline, and notifies your endpoint when the result is ready. No image processing to run yourself.

    • Bearer API keys, scoped per account
    • Idempotent job creation
    • Signed webhooks + polling
    • EU AI Act / AB 723 disclosure on every asset
    curl https://api.lumistate.com/v1/jobs \
      -H "Authorization: Bearer ls_live_…" \
      -H "Idempotency-Key: mls-7781-kitchen" \
      -d '{
        "intent": "lived_in",
        "image_url": "https://portal.example/123.jpg",
        "callback_url": "https://portal.example/hooks"
      }'
    
    # → 202 Accepted
    { "id": "job_a1b2", "status": "queued" }

    Built for platforms

    For portals, MLS and CRMs

    Listing portals

    Enhance photos at ingestion so every listing on your portal looks studio-shot - white-label, under your brand, no agent action needed.

    MLS systems

    Offer member agents one-click enhancement and compliant disclosures directly inside your MLS, fed by a single API integration.

    Portfolio backfill

    Re-process an entire back catalog of listings in bulk, then keep new uploads enhanced automatically going forward.

    CRMs & feed tools

    Pipe images through enhancement as part of your existing RESO / feed sync, with results returned by webhook.

    The endpoints

    Everything Lumistate does, as an API

    The pipeline is live in the product today. These are the endpoints rolling out as the public API opens.

    Coming soon

    Enhance

    studio enhancement

    Studio-grade correction: HDR, perspective, sky and exterior cleanup on a raw upload.

    POST /v1/jobs · intent: just_clean_up
    Coming soon

    Declutter

    declutter

    Remove clutter and personal items, then add light home-staging touches.

    POST /v1/jobs · intent: lived_in
    Coming soon

    Virtual staging

    virtual staging

    Furnish an empty room programmatically, with selectable styles.

    POST /v1/jobs · intent: stage_empty
    Coming soon

    3D tours

    3D tours

    Generate an immersive walk-through from a set of room photos.

    POST /v1/tours
    Coming soon

    Floor plans

    floor plans

    Derive a clean 2D floor plan from listing photos and dimensions.

    POST /v1/floorplans
    Coming soon

    AI video

    AI video

    Turn a listing's stills into a narrated short-form reel.

    POST /v1/videos
    Coming soon

    Webhooks

    webhooks

    Signed callbacks the moment a job finishes - no polling required.

    event: job.completed
    Coming soon

    Bulk batches

    bulk processing

    Backfill an entire portfolio in one call and track it as a listing.

    POST /v1/jobs · photos[]

    Compliant by default

    Disclosure travels with the asset

    Every image the API generates is AI-edited, and Lumistate attaches the right disclosure automatically - so your platform stays compliant without writing the compliance logic yourself.

    EU AI Act

    Transparency labelling on AI-altered images for EU listings.

    AB 723 (US)

    Watermarked copy + audit trail for California disclosures.

    Data residency

    EU or US storage region per integration. GDPR-aligned.

    Audit trail

    Every job and asset version is logged and retrievable.

    Building a portal or MLS integration?

    We're onboarding early API partners now. Tell us what you're building and we'll get you in before the public launch - with docs, a sandbox key, and direct support.

    No commitment · Shape the API before it ships