Claim Codes

Every image staged via the API gets a claim code (e.g., SS-7X9K2M). Estate agents use this code to transfer the staged images into their StagingSpaces dashboard.

How It Works

Claim code lifecycle

Generated — Created automatically when you stage an image
Active — Valid for 30 days
Claimed — Agent redeems the code, images transfer to their dashboard
Expired — Unclaimed after 30 days

Preview before claiming

Agents can check what’s in a claim code before redeeming:

curl -X POST .../api/v1/claim/preview \
  -H "Authorization: Bearer <firebase-token>" \
  -H "Content-Type: application/json" \
  -d '{"code": "SS-7X9K2M"}'

{
  "valid": true,
  "code": "SS-7X9K2M",
  "image_count": 3,
  "is_claimed": false,
  "expires_at": "2026-04-24T12:00:00Z",
  "days_until_expiry": 30
}

When an agent claims images with product placement enabled, they earn 50% of ad impression revenue from those images. This incentivizes agents to use and share staged images.

Getting Started

Core Concepts

Claim Codes

Claim Codes

How It Works

Claim code lifecycle

Preview before claiming

​Claim Codes

​How It Works

​Claim code lifecycle

​Preview before claiming

​Revenue sharing

Claim Codes

How It Works

Claim code lifecycle

Preview before claiming

Revenue sharing