Skip to Content
PropertyPixel Docs

Create a quote

POST
/quotes

Price a spending request without running it. Pass the returned id as quote_id to the operation within 10 minutes.

Requires a connection with edit access.

Authorization

headerAuthorizationBearer <pp_live_…>

An API key from Settings → Developers (pp_live_…), or an OAuth access token.

Header Parameters

Idempotency-Key?string

A unique key (for example a UUID) that makes retries safe. A retry with the same key and body returns the stored response; the same key with a different body returns 422. Keys last 24 hours.

Lengthlength <= 255

Request Body

application/json
  1. body
operation*string

The spending operation to price.

Value in"enhance_photos""stage_photos""apply_recommendations""edit_listing_video""generate_listing_video_ai"
input*

The exact body you will send to that operation.

Response Body

Create a quote

application/json
  1. response
object*string
id*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
operation*string

The operation this quote prices, e.g. enhance_photos.

credits*integer

Total credits the request will spend.

balance*
sufficient*boolean

False when the balance can't cover the request.

description*string
lines*array<>
watermarked*boolean

True for trial accounts: results carry a watermark.

expires_at*string
Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
Formatdate-time
manage_credits_url*|

Where to add credits. Null inside ChatGPT.

confirm_instructions*string
Example Request
curl -X POST 'https://api.propertypixel.app/v1/quotes' \  -H 'Content-Type: application/json' \  -d '{  "operation": "enhance_photos",  "input": {    "property1": null,    "property2": null  }}'
Example Response
{  "object": "quote",  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "operation": "string",  "credits": 0,  "balance": {    "available": 0,    "after": 0  },  "sufficient": true,  "description": "string",  "lines": [    {      "label": "string",      "quantity": 0,      "unit_credits": 0    }  ],  "watermarked": true,  "expires_at": "2019-08-24T14:15:22Z",  "manage_credits_url": "string",  "confirm_instructions": "string"}