---
title: "List a property's photos"
method: POST
path: "/api/list_property_images"
tags: ["Properties"]
---

# List a property's photos

`POST /api/list_property_images`

## Request

- Base URL: `https://app.pedra.ai`
- URL: `https://app.pedra.ai/api/list_property_images`
- Auth: none required

Returns a property's photos as public img.pedra.ai URLs — ready to pass to /api/create_video or the image-editing endpoints. Pass type "360" to list 360° photos instead.

## Request body

- object
  - `apiKey` string, required: Account API key, sent in the request body. Get one at https://app.pedra.ai under Settings → API.
  - `propertyId` string, required: The property's id (from /api/list_properties).
  - `type` 'photo' | '360': "photo" (default) lists regular photos; "360" lists the property's 360° photos (their imageIds are the sceneIds of a virtual tour).

## Response `200`

The property's photos.

- object
  - `propertyId` string
  - `name` string
  - `images` object[]
    - `imageId` string
    - `url` string
    - `name` string
    - `aspectRatio` number

## Other responses

- `400`: Invalid request — bad or unreachable image URL, missing required field, or validation error.
- `404`: Missing, invalid, or revoked API key.
- `405`: Wrong HTTP method — all endpoints accept POST (credits also accepts GET).

---

[API](https://skmtc.dev/pedra/apis/pedra-api.md) · [All operations](https://skmtc.dev/pedra/apis/pedra-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pedra/apis/pedra-api/revisions/87b2e76912c8?raw)