# API reference (https://docs.propertypixel.app/api)

Every REST endpoint, generated from the same operations as the MCP tools.



The REST API lives at `https://api.propertypixel.app/v1`. Every endpoint matches an [MCP tool](/docs/mcp-tools): same parameters, same result.

```bash
curl https://api.propertypixel.app/v1/account \
  -H "Authorization: Bearer $PP_API_KEY"
```

* **Authentication:** a personal API key (`pp_live_…`) or an OAuth access token, sent as a bearer token. See [Authentication](/docs/authentication).
* **OpenAPI:** the full OpenAPI 3.1 document is at [`https://api.propertypixel.app/v1/openapi.json`](https://api.propertypixel.app/v1/openapi.json). Import it into Postman, Insomnia or a client generator.
* **Spending credits:** spending endpoints return a quote first. Confirm with `quote_id`, or send `auto_confirm: true` with an API key. See [Credits and quotes](/docs/credits-and-quotes).
* **Conventions:** errors use RFC 9457 problem details ([Errors](/docs/errors)). Writes accept an `Idempotency-Key`, lists page with `cursor`, and every response carries [rate-limit headers](/docs/rate-limits).

## Endpoints [#endpoints]

| Group                                                            | What it covers                                               |
| ---------------------------------------------------------------- | ------------------------------------------------------------ |
| [Account](/docs/api/account/get_account)                         | The connected workspace, plan and credit balance             |
| [Projects](/docs/api/projects/list_projects)                     | Create, list, read and delete listing projects; show results |
| [Photos](/docs/api/photos/add_photos)                            | Add photos by URL, or delete them                            |
| [Uploads](/docs/api/uploads/create_upload)                       | Signed uploads and upload links                              |
| [Edit options](/docs/api/edit-options/list_edit_options)         | Every enhancement type, staging style and video setting      |
| [Editing](/docs/api/editing/enhance_photos)                      | Enhance and virtually stage photos                           |
| [Video](/docs/api/video/create_video)                            | Photo to Video clips and Listing Tours                       |
| [Recommendations](/docs/api/recommendations/get_recommendations) | Free AI suggestions per photo, and applying them             |
| [Jobs](/docs/api/jobs/get_job_status)                            | Job status and details, and picking favourite results        |
| [Downloads](/docs/api/downloads/get_download_link)               | Signed download links and zips                               |
| [Quotes](/docs/api/quotes/create_quote)                          | Price a spending request before running it                   |