Prospect Photos

Photos belong to the prospect's property, so these endpoints work for property prospects only. Adding a photo needs an API key created by a user.

Method	Path	Description
`GET`	`/v1/prospects/{id}/photos`	List photos, newest first
`POST`	`/v1/prospects/{id}/photos`	Add a photo
`DELETE`	`/v1/prospects/{id}/photos/{photo_id}`	Remove a photo

body image_base64string

Base64 JPEG, PNG, or WebP. Keep the request under 1 MB; use image_url for larger files.

body image_urlstring

Public https URL of the image to copy in (up to 10 MB).

body photo_typestringdefault: other

street_view, property_front, property_side, property_back, condition, damage, or other.

body captionstring

Up to 500 characters.

body latitudenumber

Where the photo was taken.

body longitudenumber

Where the photo was taken.

Response example

12345678910111213141516{
  "data": {
    "id": "photo_44",
    "property_id": "prop_12345",
    "url": "https://storage.googleapis.com/dealmachine-media/organization/42/12345/1756224000_a1b2c3.jpg",
    "file_name": "1756224000_a1b2c3.jpg",
    "file_size": 204800,
    "mime_type": "image/jpeg",
    "width": 1600,
    "height": 1200,
    "location": { "lat": 30.2672, "lng": -97.7431 },
    "photo_type": "property_front",
    "caption": "Roof looks new",
    "created_at": "2026-08-26T16:30:00.000Z"
  }
}