Skip to main content

​
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

  1. Generated — Created automatically when you stage an image
  2. Active — Valid for 30 days
  3. Claimed — Agent redeems the code, images transfer to their dashboard
  4. 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
}

​
Revenue sharing

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.