Deals

Resale, new-booking and rental deals: stages, parties, values, documents, commission terms and splits.

GET/v1/deals

List deals

Keyset-paginated deals within the caller’s scope (owner). `filter` takes DEAL_FILTER_FIELDS; `q` matches the title or a D- reference. Sort keys: created_at (default, descending), updated_at, agreed_value, token_date, closed_at, number.

Access: API key with deals:read, or a member session. Permission deals.view.

Parameters

cursorquery: string
Opaque cursor from the previous page (`meta.next_cursor`).
limitquery: integer
Page size, 1–200.
sortquery: string
Comma list of sort keys, "-" prefix for descending, e.g. -received_at.
filterquery: string
Filter tree ({ all | any | not | field/op/value }) as JSON or base64url(JSON).
qquery: string
Free-text search.
viewquery: "open" | "won" | "lost" | "all"
open (default), won, lost or all.
stagequery: DealStage
offer_made, owner_review, accepted and move_in belong to rental deals only (R-01).
typequery: DealType
kindquery: "sale" | "rental"
sale, or rental (rent and lease together: the rental pipeline).
owner_idquery: string
A member id, or `me`.
lead_idquery: Id
Opaque record id.
property_idquery: Id
Opaque record id.

Response · 200

datarequired: array of DealSummary
metarequired: PageMeta

Request

curl -X GET 'https://api.propzolo.com/v1/deals' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": [
    {
      "id": "cmusrceel0000q7kaafxqi1om",
      "ref": "D-1024",
      "number": 0,
      "type": "sale",
      "kind": "resale",
      "stage": "negotiation",
      "title": "string",
      "contact": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "lead": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "ref": "string"
      },
      "property": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "ref_code": "string",
        "title": "string"
      },
      "project": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "unit": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "unit_no": "string"
      },
      "owner": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "agreed_value": 850000000,
      "token_amount": 850000000,
      "token_date": "2026-10-06",
      "agreement_date": "2026-10-06",
      "registration_date": "2026-10-06",
      "handover_date": "2026-10-06",
      "commission_amount": 850000000,
      "commission_received": 850000000,
      "lost_reason": "string",
      "closed_at": "2026-10-06T05:30:00.000Z",
      "created_at": "2026-10-06T05:30:00.000Z",
      "updated_at": "2026-10-06T05:30:00.000Z"
    }
  ],
  "meta": {
    "next_cursor": "string",
    "has_more": true
  }
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/deals

Open a deal

From a lead (`lead_id`: contact, listing / project, owner and type default from the lead; an open deal of the lead is returned instead of a second one) or by hand (`type` + a client). Writes D- reference, timeline, audit and `deal.created`.

Access: API key with deals:write, or a member session. Permission deals.create.

Parameters

Idempotency-Keyheader: string
Unique key (a UUID) per logical request. A retry with the same key and body replays the first response for 24 hours (marked Idempotent-Replayed: true); the same key with another body is a 409.

Request body

title: string
contact_id: Id
The primary client; default: the lead’s contact or the first party.
parties: DealPartiesInput
property_id: Id or null
Opaque record id.
project_id: Id or null
Opaque record id.
unit_id: Id or null
Opaque record id.
owner_id: Id or null
Opaque record id.
agreed_value: PaiseInput or null
Money in paise (₹1 = 100): an integer, or a digit string for huge amounts.
token_amount: PaiseInput or null
Money in paise (₹1 = 100): an integer, or a digit string for huge amounts.
token_mode: PaymentMode or null
token_date: LocalDate or null
Calendar date YYYY-MM-DD in the company time zone.
agreement_date: LocalDate or null
Calendar date YYYY-MM-DD in the company time zone.
registration_date: LocalDate or null
Calendar date YYYY-MM-DD in the company time zone.
handover_date: LocalDate or null
Calendar date YYYY-MM-DD in the company time zone.
commission: DealCommissionInput or null
notes: string or null
type: DealType
Default from the lead: buy / sell / invest → sale.
lead_id: Id or null
Opaque record id.

Response · 201

datarequired: DealDetail
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/deals' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Idempotency-Key: 6c0f1d3e-…' \
  -H 'Content-Type: application/json' \
  -d '{"title":"string","contact_id":"cmusrceel0000q7kaafxqi1om","parties":{"buyer_contact_id":"cmusrceel0000q7kaafxqi1om","seller_contact_id":"cmusrceel0000q7kaafxqi1om","tenant_contact_id":"cmusrceel0000q7kaafxqi1om","landlord_contact_id":"cmusrceel0000q7kaafxqi1om"},"property_id":"cmusrceel0000q7kaafxqi1om","project_id":"cmusrceel0000q7kaafxqi1om","unit_id":"cmusrceel0000q7kaafxqi1om","owner_id":"cmusrceel0000q7kaafxqi1om","agreed_value":0,"token_amount":0,"token_mode":"upi","token_date":"2026-10-06","agreement_date":"2026-10-06","registration_date":"2026-10-06","handover_date":"2026-10-06","commission":{"sides":[{"side":"buyer","basis":"percent","rate":0,"amount":0}],"co_broker_contact_id":"cmusrceel0000q7kaafxqi1om","co_broker_share_pct":0},"notes":"string","type":"sale","lead_id":"cmusrceel0000q7kaafxqi1om"}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "ref": "D-1024",
    "number": 0,
    "type": "sale",
    "kind": "resale",
    "stage": "negotiation",
    "title": "string",
    "contact": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "lead": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "ref": "string"
    },
    "property": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "ref_code": "string",
      "title": "string"
    },
    "project": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "unit": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "unit_no": "string"
    },
    "owner": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "agreed_value": 850000000,
    "token_amount": 850000000,
    "token_date": "2026-10-06",
    "agreement_date": "2026-10-06",
    "registration_date": "2026-10-06",
    "handover_date": "2026-10-06",
    "commission_amount": 850000000,
    "commission_received": 850000000,
    "lost_reason": "string",
    "closed_at": "2026-10-06T05:30:00.000Z",
    "created_at": "2026-10-06T05:30:00.000Z",
    "updated_at": "2026-10-06T05:30:00.000Z",
    "parties": [
      {
        "role": "buyer",
        "contact": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        }
      }
    ],
    "token_mode": "upi",
    "commission_basis": "string",
    "commission_rate": "string",
    "commission": {
      "sides": [
        {
          "side": "buyer",
          "basis": "percent",
          "rate": "string",
          "amount": 850000000,
          "expected": 850000000
        }
      ],
      "gross": 850000000,
      "co_broker": {
        "contact": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "share_pct": "string",
        "amount": 850000000
      },
      "net": 850000000,
      "received": 850000000,
      "outstanding": 850000000
    },
    "splits": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "member": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "role": "sourcing",
        "share_pct": "string",
        "amount": 850000000
      }
    ],
    "documents": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "kind": "token_receipt",
        "name": "string",
        "content_type": "string",
        "size": 0,
        "receipt_id": "cmusrceel0000q7kaafxqi1om",
        "uploaded_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "scan_status": "pending"
      }
    ],
    "notes": "string",
    "renewal_of_agreement_id": "cmusrceel0000q7kaafxqi1om",
    "capabilities": {
      "edit": true,
      "delete": true,
      "approve": true,
      "commission": "hidden",
      "splits": "hidden",
      "record_receipts": true,
      "payouts": true
    }
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

GET/v1/deals/commission-summary

Commission tiles

Expected, received and outstanding commission this month or quarter (company time zone) over the deals in scope. A deal counts in the period of its latest milestone (closed, registration, agreement, token, created). Needs the deal.commission field rule in clear.

Access: Signed-in members only (web or Android session) — not for API keys. Permission deals.view.

Parameters

periodquery: "month" | "quarter"

Response · 200

datarequired: CommissionSummary
metarequired: object

Request

curl -X GET 'https://api.propzolo.com/v1/deals/commission-summary' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "period": "month",
    "from": "2026-10-06",
    "to": "2026-10-06",
    "deals": 0,
    "expected": 850000000,
    "received": 850000000,
    "outstanding": 850000000,
    "outstanding_all": 850000000
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

GET/v1/deals/members

Members for owners and splits

Active members the caller may hand deals to (their deals.edit scope), A → Z.

Access: API key with deals:read, or a member session. Permission deals.view.

Response · 200

datarequired: array of MemberRef
metarequired: object

Request

curl -X GET 'https://api.propzolo.com/v1/deals/members' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": [
    {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    }
  ],
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

GET/v1/deals/summary

Deals per stage

Count and value per stage (the board’s column headers), with the same filters as the list.

Access: API key with deals:read, or a member session. Permission deals.view.

Parameters

filterquery: string
Filter tree ({ all | any | not | field/op/value }) as JSON or base64url(JSON).
qquery: string
Free-text search.
typequery: DealType
kindquery: "sale" | "rental"
sale, or rental (rent and lease together: the rental pipeline).
owner_idquery: string
A member id, or `me`.
lead_idquery: Id
Opaque record id.
property_idquery: Id
Opaque record id.

Response · 200

datarequired: DealStageSummary
metarequired: object

Request

curl -X GET 'https://api.propzolo.com/v1/deals/summary' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "stages": [
      {
        "stage": "negotiation",
        "count": 0,
        "value": 850000000,
        "rent": 850000000,
        "commission": 850000000
      }
    ]
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

GET/v1/deals/{id}

A deal

Access: API key with deals:read, or a member session. Permission deals.view.

Parameters

idpathrequired: Id
Opaque record id.

Response · 200

datarequired: DealDetail
metarequired: object

Request

curl -X GET 'https://api.propzolo.com/v1/deals/{id}' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "ref": "D-1024",
    "number": 0,
    "type": "sale",
    "kind": "resale",
    "stage": "negotiation",
    "title": "string",
    "contact": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "lead": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "ref": "string"
    },
    "property": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "ref_code": "string",
      "title": "string"
    },
    "project": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "unit": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "unit_no": "string"
    },
    "owner": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "agreed_value": 850000000,
    "token_amount": 850000000,
    "token_date": "2026-10-06",
    "agreement_date": "2026-10-06",
    "registration_date": "2026-10-06",
    "handover_date": "2026-10-06",
    "commission_amount": 850000000,
    "commission_received": 850000000,
    "lost_reason": "string",
    "closed_at": "2026-10-06T05:30:00.000Z",
    "created_at": "2026-10-06T05:30:00.000Z",
    "updated_at": "2026-10-06T05:30:00.000Z",
    "parties": [
      {
        "role": "buyer",
        "contact": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        }
      }
    ],
    "token_mode": "upi",
    "commission_basis": "string",
    "commission_rate": "string",
    "commission": {
      "sides": [
        {
          "side": "buyer",
          "basis": "percent",
          "rate": "string",
          "amount": 850000000,
          "expected": 850000000
        }
      ],
      "gross": 850000000,
      "co_broker": {
        "contact": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "share_pct": "string",
        "amount": 850000000
      },
      "net": 850000000,
      "received": 850000000,
      "outstanding": 850000000
    },
    "splits": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "member": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "role": "sourcing",
        "share_pct": "string",
        "amount": 850000000
      }
    ],
    "documents": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "kind": "token_receipt",
        "name": "string",
        "content_type": "string",
        "size": 0,
        "receipt_id": "cmusrceel0000q7kaafxqi1om",
        "uploaded_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "scan_status": "pending"
      }
    ],
    "notes": "string",
    "renewal_of_agreement_id": "cmusrceel0000q7kaafxqi1om",
    "capabilities": {
      "edit": true,
      "delete": true,
      "approve": true,
      "commission": "hidden",
      "splits": "hidden",
      "record_receipts": true,
      "payouts": true
    }
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

PATCH/v1/deals/{id}

Update a deal

Values, dates, parties, links and notes; commission terms need deal.commission in clear.

Access: API key with deals:write, or a member session. Permission deals.edit.

Parameters

idpathrequired: Id
Opaque record id.

Request body

title: string
contact_id: Id
The primary client; default: the lead’s contact or the first party.
parties: DealPartiesInput
property_id: Id or null
Opaque record id.
project_id: Id or null
Opaque record id.
unit_id: Id or null
Opaque record id.
owner_id: Id or null
Opaque record id.
agreed_value: PaiseInput or null
Money in paise (₹1 = 100): an integer, or a digit string for huge amounts.
token_amount: PaiseInput or null
Money in paise (₹1 = 100): an integer, or a digit string for huge amounts.
token_mode: PaymentMode or null
token_date: LocalDate or null
Calendar date YYYY-MM-DD in the company time zone.
agreement_date: LocalDate or null
Calendar date YYYY-MM-DD in the company time zone.
registration_date: LocalDate or null
Calendar date YYYY-MM-DD in the company time zone.
handover_date: LocalDate or null
Calendar date YYYY-MM-DD in the company time zone.
commission: DealCommissionInput or null
notes: string or null
request_approval: object or null
Ask for approval when a policy requires it: the chain is raised and returned in meta.approval.
request_approval.note: string or null

Response · 200

datarequired: DealDetail
metarequired: object

Request

curl -X PATCH 'https://api.propzolo.com/v1/deals/{id}' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"title":"string","contact_id":"cmusrceel0000q7kaafxqi1om","parties":{"buyer_contact_id":"cmusrceel0000q7kaafxqi1om","seller_contact_id":"cmusrceel0000q7kaafxqi1om","tenant_contact_id":"cmusrceel0000q7kaafxqi1om","landlord_contact_id":"cmusrceel0000q7kaafxqi1om"},"property_id":"cmusrceel0000q7kaafxqi1om","project_id":"cmusrceel0000q7kaafxqi1om","unit_id":"cmusrceel0000q7kaafxqi1om","owner_id":"cmusrceel0000q7kaafxqi1om","agreed_value":0,"token_amount":0,"token_mode":"upi","token_date":"2026-10-06","agreement_date":"2026-10-06","registration_date":"2026-10-06","handover_date":"2026-10-06","commission":{"sides":[{"side":"buyer","basis":"percent","rate":0,"amount":0}],"co_broker_contact_id":"cmusrceel0000q7kaafxqi1om","co_broker_share_pct":0},"notes":"string","request_approval":{"note":"string"}}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "ref": "D-1024",
    "number": 0,
    "type": "sale",
    "kind": "resale",
    "stage": "negotiation",
    "title": "string",
    "contact": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "lead": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "ref": "string"
    },
    "property": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "ref_code": "string",
      "title": "string"
    },
    "project": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "unit": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "unit_no": "string"
    },
    "owner": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "agreed_value": 850000000,
    "token_amount": 850000000,
    "token_date": "2026-10-06",
    "agreement_date": "2026-10-06",
    "registration_date": "2026-10-06",
    "handover_date": "2026-10-06",
    "commission_amount": 850000000,
    "commission_received": 850000000,
    "lost_reason": "string",
    "closed_at": "2026-10-06T05:30:00.000Z",
    "created_at": "2026-10-06T05:30:00.000Z",
    "updated_at": "2026-10-06T05:30:00.000Z",
    "parties": [
      {
        "role": "buyer",
        "contact": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        }
      }
    ],
    "token_mode": "upi",
    "commission_basis": "string",
    "commission_rate": "string",
    "commission": {
      "sides": [
        {
          "side": "buyer",
          "basis": "percent",
          "rate": "string",
          "amount": 850000000,
          "expected": 850000000
        }
      ],
      "gross": 850000000,
      "co_broker": {
        "contact": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "share_pct": "string",
        "amount": 850000000
      },
      "net": 850000000,
      "received": 850000000,
      "outstanding": 850000000
    },
    "splits": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "member": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "role": "sourcing",
        "share_pct": "string",
        "amount": 850000000
      }
    ],
    "documents": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "kind": "token_receipt",
        "name": "string",
        "content_type": "string",
        "size": 0,
        "receipt_id": "cmusrceel0000q7kaafxqi1om",
        "uploaded_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "scan_status": "pending"
      }
    ],
    "notes": "string",
    "renewal_of_agreement_id": "cmusrceel0000q7kaafxqi1om",
    "capabilities": {
      "edit": true,
      "delete": true,
      "approve": true,
      "commission": "hidden",
      "splits": "hidden",
      "record_receipts": true,
      "payouts": true
    }
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

DELETE/v1/deals/{id}

Delete a deal

Soft delete; a deal with receipts cannot be deleted (mark it lost instead). When the company’s delete policy asks for approval: 409 approval_required, or — with `request_approval=1` — the chain in meta.approval (deleted false).

Access: API key or member session. Permission deals.delete.

Parameters

idpathrequired: Id
Opaque record id.
request_approvalquery: "1" | "true"
approval_notequery: string

Response · 200

datarequired: object
data.idrequired: Id
Opaque record id.
data.deletedrequired: boolean
metarequired: object

Request

curl -X DELETE 'https://api.propzolo.com/v1/deals/{id}' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "deleted": true
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

GET/v1/deals/{id}/activity

The deal’s history

Stage moves, receipts, documents and renewals of this deal, newest first (up to 100).

Access: API key with deals:read, or a member session. Permission deals.view.

Parameters

idpathrequired: Id
Opaque record id.

Response · 200

datarequired: array of Activity
metarequired: object

Request

curl -X GET 'https://api.propzolo.com/v1/deals/{id}/activity' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": [
    {
      "id": "cmusrceel0000q7kaafxqi1om",
      "type": "string",
      "title": "string",
      "body": "string",
      "meta": null,
      "is_pinned": true,
      "occurred_at": "2026-10-06T05:30:00.000Z",
      "created_at": "2026-10-06T05:30:00.000Z",
      "actor": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "lead_id": "cmusrceel0000q7kaafxqi1om",
      "contact_id": "cmusrceel0000q7kaafxqi1om",
      "edited_at": "2026-10-06T05:30:00.000Z",
      "can_edit": true
    }
  ],
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/deals/{id}/documents

Attach an uploaded document

Access: API key with deals:write, or a member session. Permission deals.edit.

Parameters

idpathrequired: Id
Opaque record id.

Request body

kindrequired: DealDocumentKind
keyrequired: string
filenamerequired: string
content_typerequired: string
sizerequired: integer

Response · 201

datarequired: DealDocument
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/deals/{id}/documents' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"kind":"token_receipt","key":"string","filename":"string","content_type":"string","size":1}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "kind": "token_receipt",
    "name": "string",
    "content_type": "string",
    "size": 0,
    "receipt_id": "cmusrceel0000q7kaafxqi1om",
    "uploaded_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "uploaded_at": "2026-10-06T05:30:00.000Z",
    "scan_status": "pending"
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/deals/{id}/documents/presign

Start a document upload

A presigned PUT into the private bucket (type and exact size signed); register it afterwards.

Access: API key with deals:write, or a member session. Permission deals.edit.

Parameters

idpathrequired: Id
Opaque record id.

Request body

kindrequired: DealDocumentKind
filenamerequired: string
content_typerequired: string
sizerequired: integer

Response · 200

datarequired: PresignedUpload
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/deals/{id}/documents/presign' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"kind":"token_receipt","filename":"string","content_type":"string","size":1}'

Response example

{
  "data": {
    "key": "string",
    "url": "string",
    "method": "PUT",
    "headers": {},
    "expires_at": "2026-10-06T05:30:00.000Z",
    "max_bytes": 0
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

GET/v1/deals/{id}/documents/{documentId}

Download a document

A 60-second signed URL; every open is audited.

Access: API key with deals:read, or a member session. Permission deals.view.

Parameters

idpathrequired: Id
Opaque record id.
documentIdpathrequired: Id
Opaque record id.

Response · 200

datarequired: DownloadUrl
A short-lived signed download URL.
metarequired: object

Request

curl -X GET 'https://api.propzolo.com/v1/deals/{id}/documents/{documentId}' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "url": "string",
    "expires_at": "2026-10-06T05:30:00.000Z"
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

DELETE/v1/deals/{id}/documents/{documentId}

Remove a document

Access: API key with deals:write, or a member session. Permission deals.edit.

Parameters

idpathrequired: Id
Opaque record id.
documentIdpathrequired: Id
Opaque record id.

Response · 200

datarequired: object
data.idrequired: Id
Opaque record id.
data.deletedrequired: true
metarequired: object

Request

curl -X DELETE 'https://api.propzolo.com/v1/deals/{id}/documents/{documentId}' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "deleted": true
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

PUT/v1/deals/{id}/splits

Set the internal commission splits

Replaces the splits; shares must total 100 %. Amounts divide the net commission to the paisa.

Access: Signed-in members only (web or Android session) — not for API keys. Permission deals.approve.

Parameters

idpathrequired: Id
Opaque record id.

Request body

splitsrequired: array of object
splits[].member_idrequired: Id
Opaque record id.
splits[].role: SplitRole or null
splits[].share_pctrequired: DecimalInput
A decimal such as 2 or 2.5 (number or string).

Response · 200

datarequired: DealDetail
metarequired: object

Request

curl -X PUT 'https://api.propzolo.com/v1/deals/{id}/splits' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"splits":[{"member_id":"cmusrceel0000q7kaafxqi1om","role":"sourcing","share_pct":0}]}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "ref": "D-1024",
    "number": 0,
    "type": "sale",
    "kind": "resale",
    "stage": "negotiation",
    "title": "string",
    "contact": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "lead": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "ref": "string"
    },
    "property": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "ref_code": "string",
      "title": "string"
    },
    "project": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "unit": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "unit_no": "string"
    },
    "owner": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "agreed_value": 850000000,
    "token_amount": 850000000,
    "token_date": "2026-10-06",
    "agreement_date": "2026-10-06",
    "registration_date": "2026-10-06",
    "handover_date": "2026-10-06",
    "commission_amount": 850000000,
    "commission_received": 850000000,
    "lost_reason": "string",
    "closed_at": "2026-10-06T05:30:00.000Z",
    "created_at": "2026-10-06T05:30:00.000Z",
    "updated_at": "2026-10-06T05:30:00.000Z",
    "parties": [
      {
        "role": "buyer",
        "contact": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        }
      }
    ],
    "token_mode": "upi",
    "commission_basis": "string",
    "commission_rate": "string",
    "commission": {
      "sides": [
        {
          "side": "buyer",
          "basis": "percent",
          "rate": "string",
          "amount": 850000000,
          "expected": 850000000
        }
      ],
      "gross": 850000000,
      "co_broker": {
        "contact": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "share_pct": "string",
        "amount": 850000000
      },
      "net": 850000000,
      "received": 850000000,
      "outstanding": 850000000
    },
    "splits": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "member": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "role": "sourcing",
        "share_pct": "string",
        "amount": 850000000
      }
    ],
    "documents": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "kind": "token_receipt",
        "name": "string",
        "content_type": "string",
        "size": 0,
        "receipt_id": "cmusrceel0000q7kaafxqi1om",
        "uploaded_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "scan_status": "pending"
      }
    ],
    "notes": "string",
    "renewal_of_agreement_id": "cmusrceel0000q7kaafxqi1om",
    "capabilities": {
      "edit": true,
      "delete": true,
      "approve": true,
      "commission": "hidden",
      "splits": "hidden",
      "record_receipts": true,
      "payouts": true
    }
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/deals/{id}/stage

Move a deal to another stage

Token needs an amount and date, agreement and registration their dates, won the agreed value, lost a reason. Reopening a closed deal needs deals.approve. The process guard of the deal stages applies (F-04: 422 with the reasons, override_guard for members who may); terms that need approval answer 409 approval_required. Emits `deal.stage_changed`.

Access: API key with deals:write, or a member session. Permission deals.edit.

Parameters

idpathrequired: Id
Opaque record id.

Request body

stagerequired: DealStage
offer_made, owner_review, accepted and move_in belong to rental deals only (R-01).
lost_reason: string or null
token_amount: PaiseInput or null
Money in paise (₹1 = 100): an integer, or a digit string for huge amounts.
token_mode: PaymentMode or null
token_date: LocalDate or null
Calendar date YYYY-MM-DD in the company time zone.
agreement_date: LocalDate or null
Calendar date YYYY-MM-DD in the company time zone.
registration_date: LocalDate or null
Calendar date YYYY-MM-DD in the company time zone.
handover_date: LocalDate or null
Calendar date YYYY-MM-DD in the company time zone.
note: string or null
override_guard: object or null
Override the process guard (F-04): needs the override permission; audited with the reason.
override_guard.reasonrequired: string
request_approval: object or null
Ask for approval when a policy requires it: the chain is raised and returned in meta.approval.
request_approval.note: string or null

Response · 200

datarequired: DealDetail
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/deals/{id}/stage' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"stage":"negotiation","lost_reason":"string","token_amount":0,"token_mode":"upi","token_date":"2026-10-06","agreement_date":"2026-10-06","registration_date":"2026-10-06","handover_date":"2026-10-06","note":"string","override_guard":{"reason":"string"},"request_approval":{"note":"string"}}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "ref": "D-1024",
    "number": 0,
    "type": "sale",
    "kind": "resale",
    "stage": "negotiation",
    "title": "string",
    "contact": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "lead": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "ref": "string"
    },
    "property": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "ref_code": "string",
      "title": "string"
    },
    "project": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "unit": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "unit_no": "string"
    },
    "owner": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "agreed_value": 850000000,
    "token_amount": 850000000,
    "token_date": "2026-10-06",
    "agreement_date": "2026-10-06",
    "registration_date": "2026-10-06",
    "handover_date": "2026-10-06",
    "commission_amount": 850000000,
    "commission_received": 850000000,
    "lost_reason": "string",
    "closed_at": "2026-10-06T05:30:00.000Z",
    "created_at": "2026-10-06T05:30:00.000Z",
    "updated_at": "2026-10-06T05:30:00.000Z",
    "parties": [
      {
        "role": "buyer",
        "contact": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        }
      }
    ],
    "token_mode": "upi",
    "commission_basis": "string",
    "commission_rate": "string",
    "commission": {
      "sides": [
        {
          "side": "buyer",
          "basis": "percent",
          "rate": "string",
          "amount": 850000000,
          "expected": 850000000
        }
      ],
      "gross": 850000000,
      "co_broker": {
        "contact": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "share_pct": "string",
        "amount": 850000000
      },
      "net": 850000000,
      "received": 850000000,
      "outstanding": 850000000
    },
    "splits": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "member": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "role": "sourcing",
        "share_pct": "string",
        "amount": 850000000
      }
    ],
    "documents": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "kind": "token_receipt",
        "name": "string",
        "content_type": "string",
        "size": 0,
        "receipt_id": "cmusrceel0000q7kaafxqi1om",
        "uploaded_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "scan_status": "pending"
      }
    ],
    "notes": "string",
    "renewal_of_agreement_id": "cmusrceel0000q7kaafxqi1om",
    "capabilities": {
      "edit": true,
      "delete": true,
      "approve": true,
      "commission": "hidden",
      "splits": "hidden",
      "record_receipts": true,
      "payouts": true
    }
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

GET/v1/leads/{id}/documents

Documents of a lead’s deals

KYC, agreements, token receipts and payment proofs on the deals of this lead the caller can see, newest first (the lead’s Files tab). Download each through its deal.

Access: API key with deals:read, or a member session. Permission deals.view.

Parameters

idpathrequired: Id
Opaque record id.

Response · 200

datarequired: array of LeadDocument
metarequired: object

Request

curl -X GET 'https://api.propzolo.com/v1/leads/{id}/documents' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": [
    {
      "id": "cmusrceel0000q7kaafxqi1om",
      "kind": "token_receipt",
      "name": "string",
      "content_type": "string",
      "size": 0,
      "receipt_id": "cmusrceel0000q7kaafxqi1om",
      "uploaded_by": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "uploaded_at": "2026-10-06T05:30:00.000Z",
      "scan_status": "pending",
      "deal": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "ref": "string",
        "title": "string"
      }
    }
  ],
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

{ "data": [ { "id": "cmusrceel0000q7kaafxqi1om", "ref": "D-1024", "number": 0, "type": "sale", "kind": "resale", "stage": "negotiation", "title": "string", "contact": { "id": "cmusrceel0000q7kaafxqi1om", "name": "string" }, "lead": { "id": "cmusrceel0000q7kaafxqi1om", "ref": "string" }, "property": { "id": "cmusrceel0000q7kaafxqi1om", "ref_code": "string", "title": "string" }, "project": { "id": "cmusrceel0000q7kaafxqi1om", "name": "string" }, "unit": { "id": "cmusrceel0000q7kaafxqi1om", "unit_no": "string" }, "owner": { "id": "cmusrceel0000q7kaafxqi1om", "name": "string" }, "agreed_value": 850000000, "token_amount": 850000000, "token_date": "2026-10-06", "agreement_date": "2026-10-06", "registration_date": "2026-10-06", "handover_date": "2026-10-06", "commission_amount": 850000000, "commission_received": 850000000, "lost_reason": "string", "closed_at": "2026-10-06T05:30:00.000Z", "created_at": "2026-10-06T05:30:00.000Z", "updated_at": "2026-10-06T05:30:00.000Z" } ], "meta": { "next_cursor": "string", "has_more": true } }

curl -X POST 'https://api.propzolo.com/v1/deals' \ -H 'Authorization: Bearer pz_live_…' \ -H 'Idempotency-Key: 6c0f1d3e-…' \ -H 'Content-Type: application/json' \ -d '{"title":"string","contact_id":"cmusrceel0000q7kaafxqi1om","parties":{"buyer_contact_id":"cmusrceel0000q7kaafxqi1om","seller_contact_id":"cmusrceel0000q7kaafxqi1om","tenant_contact_id":"cmusrceel0000q7kaafxqi1om","landlord_contact_id":"cmusrceel0000q7kaafxqi1om"},"property_id":"cmusrceel0000q7kaafxqi1om","project_id":"cmusrceel0000q7kaafxqi1om","unit_id":"cmusrceel0000q7kaafxqi1om","owner_id":"cmusrceel0000q7kaafxqi1om","agreed_value":0,"token_amount":0,"token_mode":"upi","token_date":"2026-10-06","agreement_date":"2026-10-06","registration_date":"2026-10-06","handover_date":"2026-10-06","commission":{"sides":[{"side":"buyer","basis":"percent","rate":0,"amount":0}],"co_broker_contact_id":"cmusrceel0000q7kaafxqi1om","co_broker_share_pct":0},"notes":"string","type":"sale","lead_id":"cmusrceel0000q7kaafxqi1om"}'

{ "data": { "id": "cmusrceel0000q7kaafxqi1om", "ref": "D-1024", "number": 0, "type": "sale", "kind": "resale", "stage": "negotiation", "title": "string", "contact": { "id": "cmusrceel0000q7kaafxqi1om", "name": "string" }, "lead": { "id": "cmusrceel0000q7kaafxqi1om", "ref": "string" }, "property": { "id": "cmusrceel0000q7kaafxqi1om", "ref_code": "string", "title": "string" }, "project": { "id": "cmusrceel0000q7kaafxqi1om", "name": "string" }, "unit": { "id": "cmusrceel0000q7kaafxqi1om", "unit_no": "string" }, "owner": { "id": "cmusrceel0000q7kaafxqi1om", "name": "string" }, "agreed_value": 850000000, "token_amount": 850000000, "token_date": "2026-10-06", "agreement_date": "2026-10-06", "registration_date": "2026-10-06", "handover_date": "2026-10-06", "commission_amount": 850000000, "commission_received": 850000000, "lost_reason": "string", "closed_at": "2026-10-06T05:30:00.000Z", "created_at": "2026-10-06T05:30:00.000Z", "updated_at": "2026-10-06T05:30:00.000Z", "parties": [ { "role": "buyer", "contact": { "id": "cmusrceel0000q7kaafxqi1om", "name": "string" } } ], "token_mode": "upi", "commission_basis": "string", "commission_rate": "string", "commission": { "sides": [ { "side": "buyer", "basis": "percent", "rate": "string", "amount": 850000000, "expected": 850000000 } ], "gross": 850000000, "co_broker": { "contact": { "id": "cmusrceel0000q7kaafxqi1om", "name": "string" }, "share_pct": "string", "amount": 850000000 }, "net": 850000000, "received": 850000000, "outstanding": 850000000 }, "splits": [ { "id": "cmusrceel0000q7kaafxqi1om", "member": { "id": "cmusrceel0000q7kaafxqi1om", "name": "string" }, "role": "sourcing", "share_pct": "string", "amount": 850000000 } ], "documents": [ { "id": "cmusrceel0000q7kaafxqi1om", "kind": "token_receipt", "name": "string", "content_type": "string", "size": 0, "receipt_id": "cmusrceel0000q7kaafxqi1om", "uploaded_by": { "id": "cmusrceel0000q7kaafxqi1om", "name": "string" }, "uploaded_at": "2026-10-06T05:30:00.000Z", "scan_status": "pending" } ], "notes": "string", "renewal_of_agreement_id": "cmusrceel0000q7kaafxqi1om", "capabilities": { "edit": true, "delete": true, "approve": true, "commission": "hidden", "splits": "hidden", "record_receipts": true, "payouts": true } }, "meta": {} }

{ "data": { "period": "month", "from": "2026-10-06", "to": "2026-10-06", "deals": 0, "expected": 850000000, "received": 850000000, "outstanding": 850000000, "outstanding_all": 850000000 }, "meta": {} }

{ "data": { "stages": [ { "stage": "negotiation", "count": 0, "value": 850000000, "rent": 850000000, "commission": 850000000 } ] }, "meta": {} }

curl -X PATCH 'https://api.propzolo.com/v1/deals/{id}' \ -H 'Authorization: Bearer pz_live_…' \ -H 'Content-Type: application/json' \ -d '{"title":"string","contact_id":"cmusrceel0000q7kaafxqi1om","parties":{"buyer_contact_id":"cmusrceel0000q7kaafxqi1om","seller_contact_id":"cmusrceel0000q7kaafxqi1om","tenant_contact_id":"cmusrceel0000q7kaafxqi1om","landlord_contact_id":"cmusrceel0000q7kaafxqi1om"},"property_id":"cmusrceel0000q7kaafxqi1om","project_id":"cmusrceel0000q7kaafxqi1om","unit_id":"cmusrceel0000q7kaafxqi1om","owner_id":"cmusrceel0000q7kaafxqi1om","agreed_value":0,"token_amount":0,"token_mode":"upi","token_date":"2026-10-06","agreement_date":"2026-10-06","registration_date":"2026-10-06","handover_date":"2026-10-06","commission":{"sides":[{"side":"buyer","basis":"percent","rate":0,"amount":0}],"co_broker_contact_id":"cmusrceel0000q7kaafxqi1om","co_broker_share_pct":0},"notes":"string","request_approval":{"note":"string"}}'

{ "data": [ { "id": "cmusrceel0000q7kaafxqi1om", "type": "string", "title": "string", "body": "string", "meta": null, "is_pinned": true, "occurred_at": "2026-10-06T05:30:00.000Z", "created_at": "2026-10-06T05:30:00.000Z", "actor": { "id": "cmusrceel0000q7kaafxqi1om", "name": "string" }, "lead_id": "cmusrceel0000q7kaafxqi1om", "contact_id": "cmusrceel0000q7kaafxqi1om", "edited_at": "2026-10-06T05:30:00.000Z", "can_edit": true } ], "meta": {} }

curl -X POST 'https://api.propzolo.com/v1/deals/{id}/documents' \ -H 'Authorization: Bearer pz_live_…' \ -H 'Content-Type: application/json' \ -d '{"kind":"token_receipt","key":"string","filename":"string","content_type":"string","size":1}'

{ "data": { "id": "cmusrceel0000q7kaafxqi1om", "kind": "token_receipt", "name": "string", "content_type": "string", "size": 0, "receipt_id": "cmusrceel0000q7kaafxqi1om", "uploaded_by": { "id": "cmusrceel0000q7kaafxqi1om", "name": "string" }, "uploaded_at": "2026-10-06T05:30:00.000Z", "scan_status": "pending" }, "meta": {} }

curl -X POST 'https://api.propzolo.com/v1/deals/{id}/documents/presign' \ -H 'Authorization: Bearer pz_live_…' \ -H 'Content-Type: application/json' \ -d '{"kind":"token_receipt","filename":"string","content_type":"string","size":1}'

curl -X PUT 'https://api.propzolo.com/v1/deals/{id}/splits' \ -H 'Authorization: Bearer pz_live_…' \ -H 'Content-Type: application/json' \ -d '{"splits":[{"member_id":"cmusrceel0000q7kaafxqi1om","role":"sourcing","share_pct":0}]}'

curl -X POST 'https://api.propzolo.com/v1/deals/{id}/stage' \ -H 'Authorization: Bearer pz_live_…' \ -H 'Content-Type: application/json' \ -d '{"stage":"negotiation","lost_reason":"string","token_amount":0,"token_mode":"upi","token_date":"2026-10-06","agreement_date":"2026-10-06","registration_date":"2026-10-06","handover_date":"2026-10-06","note":"string","override_guard":{"reason":"string"},"request_approval":{"note":"string"}}'

{ "data": [ { "id": "cmusrceel0000q7kaafxqi1om", "kind": "token_receipt", "name": "string", "content_type": "string", "size": 0, "receipt_id": "cmusrceel0000q7kaafxqi1om", "uploaded_by": { "id": "cmusrceel0000q7kaafxqi1om", "name": "string" }, "uploaded_at": "2026-10-06T05:30:00.000Z", "scan_status": "pending", "deal": { "id": "cmusrceel0000q7kaafxqi1om", "ref": "string", "title": "string" } } ], "meta": {} }