Listing verification

The Verified badge: an agent’s visit with geotagged photos near the listing plus an ownership-document check, reviewed by someone else; expiry, invalidation and revocation.

DELETE/v1/listing-verification-documents/{id}

Remove a pending or rejected document

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

Parameters

idpathrequired: Id
Opaque record id.

Response · 200

datarequired: ListingVerificationDetail
metarequired: object

Request

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

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "property_id": "cmusrceel0000q7kaafxqi1om",
    "status": "draft",
    "method": "string",
    "visit_result": "fail",
    "started_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "started_at": "2026-10-06T05:30:00.000Z",
    "visit_started_at": "2026-10-06T05:30:00.000Z",
    "visit_ended_at": "2026-10-06T05:30:00.000Z",
    "submitted_at": "2026-10-06T05:30:00.000Z",
    "submitted_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "return_note": "string",
    "reviewed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "reviewed_at": "2026-10-06T05:30:00.000Z",
    "review_note": "string",
    "self_reviewed": true,
    "verified_at": "2026-10-06T05:30:00.000Z",
    "expires_at": "2026-10-06T05:30:00.000Z",
    "valid_until": "2026-10-06",
    "ended_at": "2026-10-06T05:30:00.000Z",
    "end_reason": "string",
    "end_note": "string",
    "listing": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "ref_code": "string",
      "title": "string",
      "listing_type": "string",
      "status": "string",
      "city": "string",
      "society_name": "string",
      "building": "string",
      "unit_no": "string",
      "address": "string",
      "pincode": "string",
      "latitude": 0,
      "longitude": 0,
      "location_precision": "exact",
      "pinned": true,
      "owner_name": "string"
    },
    "rule": {
      "radius_m": 0,
      "max_accuracy_m": 0
    },
    "checklist": [
      {
        "key": "string",
        "label": "string",
        "required": true,
        "hint": "string"
      }
    ],
    "evaluation": {
      "result": "fail",
      "reasons": [
        {
          "code": "string",
          "severity": "fail",
          "slot": "string",
          "photo_id": "cmusrceel0000q7kaafxqi1om",
          "text": "string"
        }
      ],
      "centre": {
        "lat": 0,
        "lng": 0
      },
      "against": "listing",
      "missing": [
        "string"
      ]
    },
    "location_confirmed_at": "2026-10-06T05:30:00.000Z",
    "location_confirmed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "photos": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "slot": "string",
        "status": "processing",
        "failure": "string",
        "preview_url": "string",
        "preview_expires_at": "2026-10-06T05:30:00.000Z",
        "width": 0,
        "height": 0,
        "captured_at": "2026-10-06T05:30:00.000Z",
        "captured_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "time_source": "string",
        "device": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "device_fix_at": "2026-10-06T05:30:00.000Z",
        "exif": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "exif_taken_at": "2026-10-06T05:30:00.000Z",
        "exif_time_source": "string",
        "distance_m": 0,
        "result": "pending",
        "flags": [
          {
            "code": "string",
            "severity": "fail",
            "text": "string"
          }
        ]
      }
    ],
    "replaced_photos": 0,
    "documents": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "kind": "string",
        "kind_label": "string",
        "status": "pending",
        "filename": "string",
        "content_type": "string",
        "size_bytes": 0,
        "uploaded_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "name_match": "match",
        "address_match": "match",
        "document_date": "2026-10-06",
        "note": "string",
        "reviewed_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "reviewed_at": "2026-10-06T05:30:00.000Z",
        "scan_status": "string"
      }
    ],
    "document_counts": {
      "approved": 0,
      "pending": 0,
      "rejected": 0
    },
    "document_kinds": [
      "sale_deed"
    ],
    "min_documents": 0,
    "visitors": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      }
    ],
    "grant_refusal": "string",
    "can": {
      "capture": true,
      "add_documents": true,
      "submit": true,
      "cancel": true,
      "review_documents": true,
      "decide": true,
      "send_back": true,
      "confirm_location": true,
      "open_documents": true,
      "revoke": 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/listing-verification-documents/{id}/download

Open an ownership document (60-second signed URL)

Needs the owner details in clear; every open is audited; a quarantined file is refused.

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

Parameters

idpathrequired: 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/listing-verification-documents/{id}/download' \
  -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.

POST/v1/listing-verification-documents/{id}/review

Approve or reject an ownership document

Approving needs the name and address recorded as matching (or partly); rejecting needs a note.

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

Parameters

idpathrequired: Id
Opaque record id.

Request body

statusrequired: "approved" | "rejected"
name_match: "match" | "partial" | "mismatch" or null
address_match: "match" | "partial" | "mismatch" or null
document_date: LocalDate or null
Calendar date YYYY-MM-DD in the company time zone.
note: string or null

Response · 200

datarequired: ListingVerificationDetail
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/listing-verification-documents/{id}/review' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"status":"approved","name_match":"match","address_match":"match","document_date":"2026-10-06","note":"string"}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "property_id": "cmusrceel0000q7kaafxqi1om",
    "status": "draft",
    "method": "string",
    "visit_result": "fail",
    "started_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "started_at": "2026-10-06T05:30:00.000Z",
    "visit_started_at": "2026-10-06T05:30:00.000Z",
    "visit_ended_at": "2026-10-06T05:30:00.000Z",
    "submitted_at": "2026-10-06T05:30:00.000Z",
    "submitted_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "return_note": "string",
    "reviewed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "reviewed_at": "2026-10-06T05:30:00.000Z",
    "review_note": "string",
    "self_reviewed": true,
    "verified_at": "2026-10-06T05:30:00.000Z",
    "expires_at": "2026-10-06T05:30:00.000Z",
    "valid_until": "2026-10-06",
    "ended_at": "2026-10-06T05:30:00.000Z",
    "end_reason": "string",
    "end_note": "string",
    "listing": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "ref_code": "string",
      "title": "string",
      "listing_type": "string",
      "status": "string",
      "city": "string",
      "society_name": "string",
      "building": "string",
      "unit_no": "string",
      "address": "string",
      "pincode": "string",
      "latitude": 0,
      "longitude": 0,
      "location_precision": "exact",
      "pinned": true,
      "owner_name": "string"
    },
    "rule": {
      "radius_m": 0,
      "max_accuracy_m": 0
    },
    "checklist": [
      {
        "key": "string",
        "label": "string",
        "required": true,
        "hint": "string"
      }
    ],
    "evaluation": {
      "result": "fail",
      "reasons": [
        {
          "code": "string",
          "severity": "fail",
          "slot": "string",
          "photo_id": "cmusrceel0000q7kaafxqi1om",
          "text": "string"
        }
      ],
      "centre": {
        "lat": 0,
        "lng": 0
      },
      "against": "listing",
      "missing": [
        "string"
      ]
    },
    "location_confirmed_at": "2026-10-06T05:30:00.000Z",
    "location_confirmed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "photos": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "slot": "string",
        "status": "processing",
        "failure": "string",
        "preview_url": "string",
        "preview_expires_at": "2026-10-06T05:30:00.000Z",
        "width": 0,
        "height": 0,
        "captured_at": "2026-10-06T05:30:00.000Z",
        "captured_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "time_source": "string",
        "device": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "device_fix_at": "2026-10-06T05:30:00.000Z",
        "exif": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "exif_taken_at": "2026-10-06T05:30:00.000Z",
        "exif_time_source": "string",
        "distance_m": 0,
        "result": "pending",
        "flags": [
          {
            "code": "string",
            "severity": "fail",
            "text": "string"
          }
        ]
      }
    ],
    "replaced_photos": 0,
    "documents": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "kind": "string",
        "kind_label": "string",
        "status": "pending",
        "filename": "string",
        "content_type": "string",
        "size_bytes": 0,
        "uploaded_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "name_match": "match",
        "address_match": "match",
        "document_date": "2026-10-06",
        "note": "string",
        "reviewed_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "reviewed_at": "2026-10-06T05:30:00.000Z",
        "scan_status": "string"
      }
    ],
    "document_counts": {
      "approved": 0,
      "pending": 0,
      "rejected": 0
    },
    "document_kinds": [
      "sale_deed"
    ],
    "min_documents": 0,
    "visitors": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      }
    ],
    "grant_refusal": "string",
    "can": {
      "capture": true,
      "add_documents": true,
      "submit": true,
      "cancel": true,
      "review_documents": true,
      "decide": true,
      "send_back": true,
      "confirm_location": true,
      "open_documents": true,
      "revoke": 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/listing-verification-photos/{id}

Remove a visit photo (kept as the trail)

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

Parameters

idpathrequired: Id
Opaque record id.

Response · 200

datarequired: ListingVerificationDetail
metarequired: object

Request

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

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "property_id": "cmusrceel0000q7kaafxqi1om",
    "status": "draft",
    "method": "string",
    "visit_result": "fail",
    "started_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "started_at": "2026-10-06T05:30:00.000Z",
    "visit_started_at": "2026-10-06T05:30:00.000Z",
    "visit_ended_at": "2026-10-06T05:30:00.000Z",
    "submitted_at": "2026-10-06T05:30:00.000Z",
    "submitted_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "return_note": "string",
    "reviewed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "reviewed_at": "2026-10-06T05:30:00.000Z",
    "review_note": "string",
    "self_reviewed": true,
    "verified_at": "2026-10-06T05:30:00.000Z",
    "expires_at": "2026-10-06T05:30:00.000Z",
    "valid_until": "2026-10-06",
    "ended_at": "2026-10-06T05:30:00.000Z",
    "end_reason": "string",
    "end_note": "string",
    "listing": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "ref_code": "string",
      "title": "string",
      "listing_type": "string",
      "status": "string",
      "city": "string",
      "society_name": "string",
      "building": "string",
      "unit_no": "string",
      "address": "string",
      "pincode": "string",
      "latitude": 0,
      "longitude": 0,
      "location_precision": "exact",
      "pinned": true,
      "owner_name": "string"
    },
    "rule": {
      "radius_m": 0,
      "max_accuracy_m": 0
    },
    "checklist": [
      {
        "key": "string",
        "label": "string",
        "required": true,
        "hint": "string"
      }
    ],
    "evaluation": {
      "result": "fail",
      "reasons": [
        {
          "code": "string",
          "severity": "fail",
          "slot": "string",
          "photo_id": "cmusrceel0000q7kaafxqi1om",
          "text": "string"
        }
      ],
      "centre": {
        "lat": 0,
        "lng": 0
      },
      "against": "listing",
      "missing": [
        "string"
      ]
    },
    "location_confirmed_at": "2026-10-06T05:30:00.000Z",
    "location_confirmed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "photos": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "slot": "string",
        "status": "processing",
        "failure": "string",
        "preview_url": "string",
        "preview_expires_at": "2026-10-06T05:30:00.000Z",
        "width": 0,
        "height": 0,
        "captured_at": "2026-10-06T05:30:00.000Z",
        "captured_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "time_source": "string",
        "device": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "device_fix_at": "2026-10-06T05:30:00.000Z",
        "exif": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "exif_taken_at": "2026-10-06T05:30:00.000Z",
        "exif_time_source": "string",
        "distance_m": 0,
        "result": "pending",
        "flags": [
          {
            "code": "string",
            "severity": "fail",
            "text": "string"
          }
        ]
      }
    ],
    "replaced_photos": 0,
    "documents": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "kind": "string",
        "kind_label": "string",
        "status": "pending",
        "filename": "string",
        "content_type": "string",
        "size_bytes": 0,
        "uploaded_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "name_match": "match",
        "address_match": "match",
        "document_date": "2026-10-06",
        "note": "string",
        "reviewed_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "reviewed_at": "2026-10-06T05:30:00.000Z",
        "scan_status": "string"
      }
    ],
    "document_counts": {
      "approved": 0,
      "pending": 0,
      "rejected": 0
    },
    "document_kinds": [
      "sale_deed"
    ],
    "min_documents": 0,
    "visitors": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      }
    ],
    "grant_refusal": "string",
    "can": {
      "capture": true,
      "add_documents": true,
      "submit": true,
      "cancel": true,
      "review_documents": true,
      "decide": true,
      "send_back": true,
      "confirm_location": true,
      "open_documents": true,
      "revoke": 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/listing-verifications

Verification queue

`submitted`: waiting for review · `draft`: visits in progress · `decided`: recent outcomes. Keyset-paginated; `meta.counts` carries the verification figures (to review, in progress, verified, expiring, lapsed).

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

Parameters

viewquery: "submitted" | "draft" | "decided"
cursorquery: string
limitquery: integer

Response · 200

datarequired: array of ListingVerificationQueueItem
metarequired: object
meta.next_cursorrequired: string or null
Opaque cursor of the next page; null on the last page.
meta.has_morerequired: boolean
meta.countsrequired: ListingVerificationCounts

Request

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

Response example

{
  "data": [
    {
      "id": "cmusrceel0000q7kaafxqi1om",
      "property_id": "cmusrceel0000q7kaafxqi1om",
      "status": "draft",
      "method": "string",
      "visit_result": "fail",
      "started_by": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "started_at": "2026-10-06T05:30:00.000Z",
      "visit_started_at": "2026-10-06T05:30:00.000Z",
      "visit_ended_at": "2026-10-06T05:30:00.000Z",
      "submitted_at": "2026-10-06T05:30:00.000Z",
      "submitted_by": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "return_note": "string",
      "reviewed_by": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "reviewed_at": "2026-10-06T05:30:00.000Z",
      "review_note": "string",
      "self_reviewed": true,
      "verified_at": "2026-10-06T05:30:00.000Z",
      "expires_at": "2026-10-06T05:30:00.000Z",
      "valid_until": "2026-10-06",
      "ended_at": "2026-10-06T05:30:00.000Z",
      "end_reason": "string",
      "end_note": "string",
      "listing": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "ref_code": "string",
        "title": "string",
        "city": "string",
        "society_name": "string"
      },
      "visitors": [
        {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        }
      ],
      "photos": {
        "total": 0,
        "flagged": 0
      },
      "documents": {
        "pending": 0,
        "approved": 0,
        "rejected": 0
      }
    }
  ],
  "meta": {
    "next_cursor": "string",
    "has_more": true,
    "counts": {
      "to_review": 0,
      "in_progress": 0,
      "verified": 0,
      "expiring": 0,
      "lapsed": 0
    }
  }
}

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/listing-verifications/{id}

One verification with its photos, documents and verdict

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

Parameters

idpathrequired: Id
Opaque record id.

Response · 200

datarequired: ListingVerificationDetail
metarequired: object

Request

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

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "property_id": "cmusrceel0000q7kaafxqi1om",
    "status": "draft",
    "method": "string",
    "visit_result": "fail",
    "started_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "started_at": "2026-10-06T05:30:00.000Z",
    "visit_started_at": "2026-10-06T05:30:00.000Z",
    "visit_ended_at": "2026-10-06T05:30:00.000Z",
    "submitted_at": "2026-10-06T05:30:00.000Z",
    "submitted_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "return_note": "string",
    "reviewed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "reviewed_at": "2026-10-06T05:30:00.000Z",
    "review_note": "string",
    "self_reviewed": true,
    "verified_at": "2026-10-06T05:30:00.000Z",
    "expires_at": "2026-10-06T05:30:00.000Z",
    "valid_until": "2026-10-06",
    "ended_at": "2026-10-06T05:30:00.000Z",
    "end_reason": "string",
    "end_note": "string",
    "listing": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "ref_code": "string",
      "title": "string",
      "listing_type": "string",
      "status": "string",
      "city": "string",
      "society_name": "string",
      "building": "string",
      "unit_no": "string",
      "address": "string",
      "pincode": "string",
      "latitude": 0,
      "longitude": 0,
      "location_precision": "exact",
      "pinned": true,
      "owner_name": "string"
    },
    "rule": {
      "radius_m": 0,
      "max_accuracy_m": 0
    },
    "checklist": [
      {
        "key": "string",
        "label": "string",
        "required": true,
        "hint": "string"
      }
    ],
    "evaluation": {
      "result": "fail",
      "reasons": [
        {
          "code": "string",
          "severity": "fail",
          "slot": "string",
          "photo_id": "cmusrceel0000q7kaafxqi1om",
          "text": "string"
        }
      ],
      "centre": {
        "lat": 0,
        "lng": 0
      },
      "against": "listing",
      "missing": [
        "string"
      ]
    },
    "location_confirmed_at": "2026-10-06T05:30:00.000Z",
    "location_confirmed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "photos": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "slot": "string",
        "status": "processing",
        "failure": "string",
        "preview_url": "string",
        "preview_expires_at": "2026-10-06T05:30:00.000Z",
        "width": 0,
        "height": 0,
        "captured_at": "2026-10-06T05:30:00.000Z",
        "captured_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "time_source": "string",
        "device": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "device_fix_at": "2026-10-06T05:30:00.000Z",
        "exif": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "exif_taken_at": "2026-10-06T05:30:00.000Z",
        "exif_time_source": "string",
        "distance_m": 0,
        "result": "pending",
        "flags": [
          {
            "code": "string",
            "severity": "fail",
            "text": "string"
          }
        ]
      }
    ],
    "replaced_photos": 0,
    "documents": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "kind": "string",
        "kind_label": "string",
        "status": "pending",
        "filename": "string",
        "content_type": "string",
        "size_bytes": 0,
        "uploaded_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "name_match": "match",
        "address_match": "match",
        "document_date": "2026-10-06",
        "note": "string",
        "reviewed_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "reviewed_at": "2026-10-06T05:30:00.000Z",
        "scan_status": "string"
      }
    ],
    "document_counts": {
      "approved": 0,
      "pending": 0,
      "rejected": 0
    },
    "document_kinds": [
      "sale_deed"
    ],
    "min_documents": 0,
    "visitors": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      }
    ],
    "grant_refusal": "string",
    "can": {
      "capture": true,
      "add_documents": true,
      "submit": true,
      "cancel": true,
      "review_documents": true,
      "decide": true,
      "send_back": true,
      "confirm_location": true,
      "open_documents": true,
      "revoke": 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/listing-verifications/{id}/cancel

Cancel an open verification

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

Parameters

idpathrequired: Id
Opaque record id.

Request body

note: string or null

Response · 200

datarequired: ListingVerificationDetail
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/listing-verifications/{id}/cancel' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"note":"string"}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "property_id": "cmusrceel0000q7kaafxqi1om",
    "status": "draft",
    "method": "string",
    "visit_result": "fail",
    "started_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "started_at": "2026-10-06T05:30:00.000Z",
    "visit_started_at": "2026-10-06T05:30:00.000Z",
    "visit_ended_at": "2026-10-06T05:30:00.000Z",
    "submitted_at": "2026-10-06T05:30:00.000Z",
    "submitted_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "return_note": "string",
    "reviewed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "reviewed_at": "2026-10-06T05:30:00.000Z",
    "review_note": "string",
    "self_reviewed": true,
    "verified_at": "2026-10-06T05:30:00.000Z",
    "expires_at": "2026-10-06T05:30:00.000Z",
    "valid_until": "2026-10-06",
    "ended_at": "2026-10-06T05:30:00.000Z",
    "end_reason": "string",
    "end_note": "string",
    "listing": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "ref_code": "string",
      "title": "string",
      "listing_type": "string",
      "status": "string",
      "city": "string",
      "society_name": "string",
      "building": "string",
      "unit_no": "string",
      "address": "string",
      "pincode": "string",
      "latitude": 0,
      "longitude": 0,
      "location_precision": "exact",
      "pinned": true,
      "owner_name": "string"
    },
    "rule": {
      "radius_m": 0,
      "max_accuracy_m": 0
    },
    "checklist": [
      {
        "key": "string",
        "label": "string",
        "required": true,
        "hint": "string"
      }
    ],
    "evaluation": {
      "result": "fail",
      "reasons": [
        {
          "code": "string",
          "severity": "fail",
          "slot": "string",
          "photo_id": "cmusrceel0000q7kaafxqi1om",
          "text": "string"
        }
      ],
      "centre": {
        "lat": 0,
        "lng": 0
      },
      "against": "listing",
      "missing": [
        "string"
      ]
    },
    "location_confirmed_at": "2026-10-06T05:30:00.000Z",
    "location_confirmed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "photos": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "slot": "string",
        "status": "processing",
        "failure": "string",
        "preview_url": "string",
        "preview_expires_at": "2026-10-06T05:30:00.000Z",
        "width": 0,
        "height": 0,
        "captured_at": "2026-10-06T05:30:00.000Z",
        "captured_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "time_source": "string",
        "device": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "device_fix_at": "2026-10-06T05:30:00.000Z",
        "exif": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "exif_taken_at": "2026-10-06T05:30:00.000Z",
        "exif_time_source": "string",
        "distance_m": 0,
        "result": "pending",
        "flags": [
          {
            "code": "string",
            "severity": "fail",
            "text": "string"
          }
        ]
      }
    ],
    "replaced_photos": 0,
    "documents": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "kind": "string",
        "kind_label": "string",
        "status": "pending",
        "filename": "string",
        "content_type": "string",
        "size_bytes": 0,
        "uploaded_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "name_match": "match",
        "address_match": "match",
        "document_date": "2026-10-06",
        "note": "string",
        "reviewed_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "reviewed_at": "2026-10-06T05:30:00.000Z",
        "scan_status": "string"
      }
    ],
    "document_counts": {
      "approved": 0,
      "pending": 0,
      "rejected": 0
    },
    "document_kinds": [
      "sale_deed"
    ],
    "min_documents": 0,
    "visitors": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      }
    ],
    "grant_refusal": "string",
    "can": {
      "capture": true,
      "add_documents": true,
      "submit": true,
      "cancel": true,
      "review_documents": true,
      "decide": true,
      "send_back": true,
      "confirm_location": true,
      "open_documents": true,
      "revoke": 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/listing-verifications/{id}/decision

Grant the Verified badge or reject the verification

Never by a member who captured the visit’s photos (unless the company allows self-review).

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

Parameters

idpathrequired: Id
Opaque record id.

Request body

decisionrequired: "approve" | "reject"
note: string or null
Required to reject.
acknowledge_flags: boolean
The reviewer checked the points flagged for review (needed when the visit is `review`).

Response · 200

datarequired: ListingVerificationDetail
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/listing-verifications/{id}/decision' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"decision":"approve","note":"string","acknowledge_flags":true}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "property_id": "cmusrceel0000q7kaafxqi1om",
    "status": "draft",
    "method": "string",
    "visit_result": "fail",
    "started_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "started_at": "2026-10-06T05:30:00.000Z",
    "visit_started_at": "2026-10-06T05:30:00.000Z",
    "visit_ended_at": "2026-10-06T05:30:00.000Z",
    "submitted_at": "2026-10-06T05:30:00.000Z",
    "submitted_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "return_note": "string",
    "reviewed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "reviewed_at": "2026-10-06T05:30:00.000Z",
    "review_note": "string",
    "self_reviewed": true,
    "verified_at": "2026-10-06T05:30:00.000Z",
    "expires_at": "2026-10-06T05:30:00.000Z",
    "valid_until": "2026-10-06",
    "ended_at": "2026-10-06T05:30:00.000Z",
    "end_reason": "string",
    "end_note": "string",
    "listing": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "ref_code": "string",
      "title": "string",
      "listing_type": "string",
      "status": "string",
      "city": "string",
      "society_name": "string",
      "building": "string",
      "unit_no": "string",
      "address": "string",
      "pincode": "string",
      "latitude": 0,
      "longitude": 0,
      "location_precision": "exact",
      "pinned": true,
      "owner_name": "string"
    },
    "rule": {
      "radius_m": 0,
      "max_accuracy_m": 0
    },
    "checklist": [
      {
        "key": "string",
        "label": "string",
        "required": true,
        "hint": "string"
      }
    ],
    "evaluation": {
      "result": "fail",
      "reasons": [
        {
          "code": "string",
          "severity": "fail",
          "slot": "string",
          "photo_id": "cmusrceel0000q7kaafxqi1om",
          "text": "string"
        }
      ],
      "centre": {
        "lat": 0,
        "lng": 0
      },
      "against": "listing",
      "missing": [
        "string"
      ]
    },
    "location_confirmed_at": "2026-10-06T05:30:00.000Z",
    "location_confirmed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "photos": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "slot": "string",
        "status": "processing",
        "failure": "string",
        "preview_url": "string",
        "preview_expires_at": "2026-10-06T05:30:00.000Z",
        "width": 0,
        "height": 0,
        "captured_at": "2026-10-06T05:30:00.000Z",
        "captured_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "time_source": "string",
        "device": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "device_fix_at": "2026-10-06T05:30:00.000Z",
        "exif": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "exif_taken_at": "2026-10-06T05:30:00.000Z",
        "exif_time_source": "string",
        "distance_m": 0,
        "result": "pending",
        "flags": [
          {
            "code": "string",
            "severity": "fail",
            "text": "string"
          }
        ]
      }
    ],
    "replaced_photos": 0,
    "documents": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "kind": "string",
        "kind_label": "string",
        "status": "pending",
        "filename": "string",
        "content_type": "string",
        "size_bytes": 0,
        "uploaded_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "name_match": "match",
        "address_match": "match",
        "document_date": "2026-10-06",
        "note": "string",
        "reviewed_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "reviewed_at": "2026-10-06T05:30:00.000Z",
        "scan_status": "string"
      }
    ],
    "document_counts": {
      "approved": 0,
      "pending": 0,
      "rejected": 0
    },
    "document_kinds": [
      "sale_deed"
    ],
    "min_documents": 0,
    "visitors": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      }
    ],
    "grant_refusal": "string",
    "can": {
      "capture": true,
      "add_documents": true,
      "submit": true,
      "cancel": true,
      "review_documents": true,
      "decide": true,
      "send_back": true,
      "confirm_location": true,
      "open_documents": true,
      "revoke": 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/listing-verifications/{id}/documents

Attach an ownership document

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

Parameters

idpathrequired: Id
Opaque record id.

Request body

kindrequired: "sale_deed" | "index_ii" | "property_tax" | "electricity_bill" | "society_noc" | "authority_letter" | …
filenamerequired: string
content_typerequired: string
sizerequired: integer
keyrequired: string

Response · 201

datarequired: ListingVerificationDetail
metarequired: object

Request

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

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "property_id": "cmusrceel0000q7kaafxqi1om",
    "status": "draft",
    "method": "string",
    "visit_result": "fail",
    "started_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "started_at": "2026-10-06T05:30:00.000Z",
    "visit_started_at": "2026-10-06T05:30:00.000Z",
    "visit_ended_at": "2026-10-06T05:30:00.000Z",
    "submitted_at": "2026-10-06T05:30:00.000Z",
    "submitted_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "return_note": "string",
    "reviewed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "reviewed_at": "2026-10-06T05:30:00.000Z",
    "review_note": "string",
    "self_reviewed": true,
    "verified_at": "2026-10-06T05:30:00.000Z",
    "expires_at": "2026-10-06T05:30:00.000Z",
    "valid_until": "2026-10-06",
    "ended_at": "2026-10-06T05:30:00.000Z",
    "end_reason": "string",
    "end_note": "string",
    "listing": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "ref_code": "string",
      "title": "string",
      "listing_type": "string",
      "status": "string",
      "city": "string",
      "society_name": "string",
      "building": "string",
      "unit_no": "string",
      "address": "string",
      "pincode": "string",
      "latitude": 0,
      "longitude": 0,
      "location_precision": "exact",
      "pinned": true,
      "owner_name": "string"
    },
    "rule": {
      "radius_m": 0,
      "max_accuracy_m": 0
    },
    "checklist": [
      {
        "key": "string",
        "label": "string",
        "required": true,
        "hint": "string"
      }
    ],
    "evaluation": {
      "result": "fail",
      "reasons": [
        {
          "code": "string",
          "severity": "fail",
          "slot": "string",
          "photo_id": "cmusrceel0000q7kaafxqi1om",
          "text": "string"
        }
      ],
      "centre": {
        "lat": 0,
        "lng": 0
      },
      "against": "listing",
      "missing": [
        "string"
      ]
    },
    "location_confirmed_at": "2026-10-06T05:30:00.000Z",
    "location_confirmed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "photos": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "slot": "string",
        "status": "processing",
        "failure": "string",
        "preview_url": "string",
        "preview_expires_at": "2026-10-06T05:30:00.000Z",
        "width": 0,
        "height": 0,
        "captured_at": "2026-10-06T05:30:00.000Z",
        "captured_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "time_source": "string",
        "device": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "device_fix_at": "2026-10-06T05:30:00.000Z",
        "exif": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "exif_taken_at": "2026-10-06T05:30:00.000Z",
        "exif_time_source": "string",
        "distance_m": 0,
        "result": "pending",
        "flags": [
          {
            "code": "string",
            "severity": "fail",
            "text": "string"
          }
        ]
      }
    ],
    "replaced_photos": 0,
    "documents": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "kind": "string",
        "kind_label": "string",
        "status": "pending",
        "filename": "string",
        "content_type": "string",
        "size_bytes": 0,
        "uploaded_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "name_match": "match",
        "address_match": "match",
        "document_date": "2026-10-06",
        "note": "string",
        "reviewed_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "reviewed_at": "2026-10-06T05:30:00.000Z",
        "scan_status": "string"
      }
    ],
    "document_counts": {
      "approved": 0,
      "pending": 0,
      "rejected": 0
    },
    "document_kinds": [
      "sale_deed"
    ],
    "min_documents": 0,
    "visitors": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      }
    ],
    "grant_refusal": "string",
    "can": {
      "capture": true,
      "add_documents": true,
      "submit": true,
      "cancel": true,
      "review_documents": true,
      "decide": true,
      "send_back": true,
      "confirm_location": true,
      "open_documents": true,
      "revoke": 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/listing-verifications/{id}/documents/uploads

Presigned upload for an ownership document

PDF (25 MB) or a photo of the document (15 MB), into the private bucket.

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

Parameters

idpathrequired: Id
Opaque record id.

Request body

kindrequired: "sale_deed" | "index_ii" | "property_tax" | "electricity_bill" | "society_noc" | "authority_letter" | …
filenamerequired: string
content_typerequired: string
sizerequired: integer

Response · 200

datarequired: PresignedUpload
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/listing-verifications/{id}/documents/uploads' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"kind":"sale_deed","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.

POST/v1/listing-verifications/{id}/location

Use the visit’s position as the listing’s map pin

Only for a listing without a pin; needs edit rights on the listing.

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

Parameters

idpathrequired: Id
Opaque record id.

Response · 200

datarequired: ListingVerificationDetail
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/listing-verifications/{id}/location' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "property_id": "cmusrceel0000q7kaafxqi1om",
    "status": "draft",
    "method": "string",
    "visit_result": "fail",
    "started_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "started_at": "2026-10-06T05:30:00.000Z",
    "visit_started_at": "2026-10-06T05:30:00.000Z",
    "visit_ended_at": "2026-10-06T05:30:00.000Z",
    "submitted_at": "2026-10-06T05:30:00.000Z",
    "submitted_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "return_note": "string",
    "reviewed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "reviewed_at": "2026-10-06T05:30:00.000Z",
    "review_note": "string",
    "self_reviewed": true,
    "verified_at": "2026-10-06T05:30:00.000Z",
    "expires_at": "2026-10-06T05:30:00.000Z",
    "valid_until": "2026-10-06",
    "ended_at": "2026-10-06T05:30:00.000Z",
    "end_reason": "string",
    "end_note": "string",
    "listing": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "ref_code": "string",
      "title": "string",
      "listing_type": "string",
      "status": "string",
      "city": "string",
      "society_name": "string",
      "building": "string",
      "unit_no": "string",
      "address": "string",
      "pincode": "string",
      "latitude": 0,
      "longitude": 0,
      "location_precision": "exact",
      "pinned": true,
      "owner_name": "string"
    },
    "rule": {
      "radius_m": 0,
      "max_accuracy_m": 0
    },
    "checklist": [
      {
        "key": "string",
        "label": "string",
        "required": true,
        "hint": "string"
      }
    ],
    "evaluation": {
      "result": "fail",
      "reasons": [
        {
          "code": "string",
          "severity": "fail",
          "slot": "string",
          "photo_id": "cmusrceel0000q7kaafxqi1om",
          "text": "string"
        }
      ],
      "centre": {
        "lat": 0,
        "lng": 0
      },
      "against": "listing",
      "missing": [
        "string"
      ]
    },
    "location_confirmed_at": "2026-10-06T05:30:00.000Z",
    "location_confirmed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "photos": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "slot": "string",
        "status": "processing",
        "failure": "string",
        "preview_url": "string",
        "preview_expires_at": "2026-10-06T05:30:00.000Z",
        "width": 0,
        "height": 0,
        "captured_at": "2026-10-06T05:30:00.000Z",
        "captured_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "time_source": "string",
        "device": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "device_fix_at": "2026-10-06T05:30:00.000Z",
        "exif": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "exif_taken_at": "2026-10-06T05:30:00.000Z",
        "exif_time_source": "string",
        "distance_m": 0,
        "result": "pending",
        "flags": [
          {
            "code": "string",
            "severity": "fail",
            "text": "string"
          }
        ]
      }
    ],
    "replaced_photos": 0,
    "documents": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "kind": "string",
        "kind_label": "string",
        "status": "pending",
        "filename": "string",
        "content_type": "string",
        "size_bytes": 0,
        "uploaded_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "name_match": "match",
        "address_match": "match",
        "document_date": "2026-10-06",
        "note": "string",
        "reviewed_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "reviewed_at": "2026-10-06T05:30:00.000Z",
        "scan_status": "string"
      }
    ],
    "document_counts": {
      "approved": 0,
      "pending": 0,
      "rejected": 0
    },
    "document_kinds": [
      "sale_deed"
    ],
    "min_documents": 0,
    "visitors": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      }
    ],
    "grant_refusal": "string",
    "can": {
      "capture": true,
      "add_documents": true,
      "submit": true,
      "cancel": true,
      "review_documents": true,
      "decide": true,
      "send_back": true,
      "confirm_location": true,
      "open_documents": true,
      "revoke": 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/listing-verifications/{id}/photos

Register a visit photo with the phone’s location fix

Replaces the item’s previous photo. The capture time is reconciled with the run’s monotonic clock when given; the photo is then checked in the background (EXIF, hashes, EXIF-free preview).

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

Parameters

idpathrequired: Id
Opaque record id.

Request body

slotrequired: string
keyrequired: string
The key from the presigned upload.
content_typerequired: string
sizerequired: integer
captured_atrequired: string (date-time)
The phone’s clock when the photo was captured.
sent_at: string (date-time) or null
The phone’s clock when this request was sent.
file_modified_at: string (date-time) or null
The file’s last-modified time (phone clock).
capture_run: string or null
Id of the page / app run that captured the photo.
capture_mono_ms: number or null
That run’s monotonic clock at capture (ms).
send_run: string or null
send_mono_ms: number or null
location: object or null
The phone’s location fix at capture (null when it shared none).
location.latrequired: number
location.lngrequired: number
location.accuracy_mrequired: number or null
location.fix_at: string (date-time) or null
The location fix’s own timestamp (phone clock).

Response · 201

datarequired: ListingVerificationDetail
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/listing-verifications/{id}/photos' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"slot":"string","key":"string","content_type":"string","size":1,"captured_at":"2026-10-06T05:30:00.000Z","sent_at":"2026-10-06T05:30:00.000Z","file_modified_at":"2026-10-06T05:30:00.000Z","capture_run":"string","capture_mono_ms":0,"send_run":"string","send_mono_ms":0,"location":{"lat":0,"lng":0,"accuracy_m":0,"fix_at":"2026-10-06T05:30:00.000Z"}}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "property_id": "cmusrceel0000q7kaafxqi1om",
    "status": "draft",
    "method": "string",
    "visit_result": "fail",
    "started_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "started_at": "2026-10-06T05:30:00.000Z",
    "visit_started_at": "2026-10-06T05:30:00.000Z",
    "visit_ended_at": "2026-10-06T05:30:00.000Z",
    "submitted_at": "2026-10-06T05:30:00.000Z",
    "submitted_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "return_note": "string",
    "reviewed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "reviewed_at": "2026-10-06T05:30:00.000Z",
    "review_note": "string",
    "self_reviewed": true,
    "verified_at": "2026-10-06T05:30:00.000Z",
    "expires_at": "2026-10-06T05:30:00.000Z",
    "valid_until": "2026-10-06",
    "ended_at": "2026-10-06T05:30:00.000Z",
    "end_reason": "string",
    "end_note": "string",
    "listing": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "ref_code": "string",
      "title": "string",
      "listing_type": "string",
      "status": "string",
      "city": "string",
      "society_name": "string",
      "building": "string",
      "unit_no": "string",
      "address": "string",
      "pincode": "string",
      "latitude": 0,
      "longitude": 0,
      "location_precision": "exact",
      "pinned": true,
      "owner_name": "string"
    },
    "rule": {
      "radius_m": 0,
      "max_accuracy_m": 0
    },
    "checklist": [
      {
        "key": "string",
        "label": "string",
        "required": true,
        "hint": "string"
      }
    ],
    "evaluation": {
      "result": "fail",
      "reasons": [
        {
          "code": "string",
          "severity": "fail",
          "slot": "string",
          "photo_id": "cmusrceel0000q7kaafxqi1om",
          "text": "string"
        }
      ],
      "centre": {
        "lat": 0,
        "lng": 0
      },
      "against": "listing",
      "missing": [
        "string"
      ]
    },
    "location_confirmed_at": "2026-10-06T05:30:00.000Z",
    "location_confirmed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "photos": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "slot": "string",
        "status": "processing",
        "failure": "string",
        "preview_url": "string",
        "preview_expires_at": "2026-10-06T05:30:00.000Z",
        "width": 0,
        "height": 0,
        "captured_at": "2026-10-06T05:30:00.000Z",
        "captured_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "time_source": "string",
        "device": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "device_fix_at": "2026-10-06T05:30:00.000Z",
        "exif": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "exif_taken_at": "2026-10-06T05:30:00.000Z",
        "exif_time_source": "string",
        "distance_m": 0,
        "result": "pending",
        "flags": [
          {
            "code": "string",
            "severity": "fail",
            "text": "string"
          }
        ]
      }
    ],
    "replaced_photos": 0,
    "documents": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "kind": "string",
        "kind_label": "string",
        "status": "pending",
        "filename": "string",
        "content_type": "string",
        "size_bytes": 0,
        "uploaded_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "name_match": "match",
        "address_match": "match",
        "document_date": "2026-10-06",
        "note": "string",
        "reviewed_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "reviewed_at": "2026-10-06T05:30:00.000Z",
        "scan_status": "string"
      }
    ],
    "document_counts": {
      "approved": 0,
      "pending": 0,
      "rejected": 0
    },
    "document_kinds": [
      "sale_deed"
    ],
    "min_documents": 0,
    "visitors": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      }
    ],
    "grant_refusal": "string",
    "can": {
      "capture": true,
      "add_documents": true,
      "submit": true,
      "cancel": true,
      "review_documents": true,
      "decide": true,
      "send_back": true,
      "confirm_location": true,
      "open_documents": true,
      "revoke": 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/listing-verifications/{id}/photos/uploads

Presigned upload for a visit photo

Into the private bucket (type and exact size signed, 15 MB). Photos only: JPEG, PNG, WebP.

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

Parameters

idpathrequired: Id
Opaque record id.

Request body

slotrequired: string
content_typerequired: string
sizerequired: integer
filename: string or null

Response · 200

datarequired: PresignedUpload
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/listing-verifications/{id}/photos/uploads' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"slot":"string","content_type":"string","size":1,"filename":"string"}'

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.

POST/v1/listing-verifications/{id}/return

Send a submitted visit back for retakes

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

Parameters

idpathrequired: Id
Opaque record id.

Request body

noterequired: string

Response · 200

datarequired: ListingVerificationDetail
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/listing-verifications/{id}/return' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"note":"string"}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "property_id": "cmusrceel0000q7kaafxqi1om",
    "status": "draft",
    "method": "string",
    "visit_result": "fail",
    "started_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "started_at": "2026-10-06T05:30:00.000Z",
    "visit_started_at": "2026-10-06T05:30:00.000Z",
    "visit_ended_at": "2026-10-06T05:30:00.000Z",
    "submitted_at": "2026-10-06T05:30:00.000Z",
    "submitted_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "return_note": "string",
    "reviewed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "reviewed_at": "2026-10-06T05:30:00.000Z",
    "review_note": "string",
    "self_reviewed": true,
    "verified_at": "2026-10-06T05:30:00.000Z",
    "expires_at": "2026-10-06T05:30:00.000Z",
    "valid_until": "2026-10-06",
    "ended_at": "2026-10-06T05:30:00.000Z",
    "end_reason": "string",
    "end_note": "string",
    "listing": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "ref_code": "string",
      "title": "string",
      "listing_type": "string",
      "status": "string",
      "city": "string",
      "society_name": "string",
      "building": "string",
      "unit_no": "string",
      "address": "string",
      "pincode": "string",
      "latitude": 0,
      "longitude": 0,
      "location_precision": "exact",
      "pinned": true,
      "owner_name": "string"
    },
    "rule": {
      "radius_m": 0,
      "max_accuracy_m": 0
    },
    "checklist": [
      {
        "key": "string",
        "label": "string",
        "required": true,
        "hint": "string"
      }
    ],
    "evaluation": {
      "result": "fail",
      "reasons": [
        {
          "code": "string",
          "severity": "fail",
          "slot": "string",
          "photo_id": "cmusrceel0000q7kaafxqi1om",
          "text": "string"
        }
      ],
      "centre": {
        "lat": 0,
        "lng": 0
      },
      "against": "listing",
      "missing": [
        "string"
      ]
    },
    "location_confirmed_at": "2026-10-06T05:30:00.000Z",
    "location_confirmed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "photos": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "slot": "string",
        "status": "processing",
        "failure": "string",
        "preview_url": "string",
        "preview_expires_at": "2026-10-06T05:30:00.000Z",
        "width": 0,
        "height": 0,
        "captured_at": "2026-10-06T05:30:00.000Z",
        "captured_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "time_source": "string",
        "device": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "device_fix_at": "2026-10-06T05:30:00.000Z",
        "exif": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "exif_taken_at": "2026-10-06T05:30:00.000Z",
        "exif_time_source": "string",
        "distance_m": 0,
        "result": "pending",
        "flags": [
          {
            "code": "string",
            "severity": "fail",
            "text": "string"
          }
        ]
      }
    ],
    "replaced_photos": 0,
    "documents": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "kind": "string",
        "kind_label": "string",
        "status": "pending",
        "filename": "string",
        "content_type": "string",
        "size_bytes": 0,
        "uploaded_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "name_match": "match",
        "address_match": "match",
        "document_date": "2026-10-06",
        "note": "string",
        "reviewed_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "reviewed_at": "2026-10-06T05:30:00.000Z",
        "scan_status": "string"
      }
    ],
    "document_counts": {
      "approved": 0,
      "pending": 0,
      "rejected": 0
    },
    "document_kinds": [
      "sale_deed"
    ],
    "min_documents": 0,
    "visitors": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      }
    ],
    "grant_refusal": "string",
    "can": {
      "capture": true,
      "add_documents": true,
      "submit": true,
      "cancel": true,
      "review_documents": true,
      "decide": true,
      "send_back": true,
      "confirm_location": true,
      "open_documents": true,
      "revoke": 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/listing-verifications/{id}/submit

Submit the visit for review

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

Parameters

idpathrequired: Id
Opaque record id.

Response · 200

datarequired: ListingVerificationDetail
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/listing-verifications/{id}/submit' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "property_id": "cmusrceel0000q7kaafxqi1om",
    "status": "draft",
    "method": "string",
    "visit_result": "fail",
    "started_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "started_at": "2026-10-06T05:30:00.000Z",
    "visit_started_at": "2026-10-06T05:30:00.000Z",
    "visit_ended_at": "2026-10-06T05:30:00.000Z",
    "submitted_at": "2026-10-06T05:30:00.000Z",
    "submitted_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "return_note": "string",
    "reviewed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "reviewed_at": "2026-10-06T05:30:00.000Z",
    "review_note": "string",
    "self_reviewed": true,
    "verified_at": "2026-10-06T05:30:00.000Z",
    "expires_at": "2026-10-06T05:30:00.000Z",
    "valid_until": "2026-10-06",
    "ended_at": "2026-10-06T05:30:00.000Z",
    "end_reason": "string",
    "end_note": "string",
    "listing": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "ref_code": "string",
      "title": "string",
      "listing_type": "string",
      "status": "string",
      "city": "string",
      "society_name": "string",
      "building": "string",
      "unit_no": "string",
      "address": "string",
      "pincode": "string",
      "latitude": 0,
      "longitude": 0,
      "location_precision": "exact",
      "pinned": true,
      "owner_name": "string"
    },
    "rule": {
      "radius_m": 0,
      "max_accuracy_m": 0
    },
    "checklist": [
      {
        "key": "string",
        "label": "string",
        "required": true,
        "hint": "string"
      }
    ],
    "evaluation": {
      "result": "fail",
      "reasons": [
        {
          "code": "string",
          "severity": "fail",
          "slot": "string",
          "photo_id": "cmusrceel0000q7kaafxqi1om",
          "text": "string"
        }
      ],
      "centre": {
        "lat": 0,
        "lng": 0
      },
      "against": "listing",
      "missing": [
        "string"
      ]
    },
    "location_confirmed_at": "2026-10-06T05:30:00.000Z",
    "location_confirmed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "photos": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "slot": "string",
        "status": "processing",
        "failure": "string",
        "preview_url": "string",
        "preview_expires_at": "2026-10-06T05:30:00.000Z",
        "width": 0,
        "height": 0,
        "captured_at": "2026-10-06T05:30:00.000Z",
        "captured_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "time_source": "string",
        "device": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "device_fix_at": "2026-10-06T05:30:00.000Z",
        "exif": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "exif_taken_at": "2026-10-06T05:30:00.000Z",
        "exif_time_source": "string",
        "distance_m": 0,
        "result": "pending",
        "flags": [
          {
            "code": "string",
            "severity": "fail",
            "text": "string"
          }
        ]
      }
    ],
    "replaced_photos": 0,
    "documents": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "kind": "string",
        "kind_label": "string",
        "status": "pending",
        "filename": "string",
        "content_type": "string",
        "size_bytes": 0,
        "uploaded_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "name_match": "match",
        "address_match": "match",
        "document_date": "2026-10-06",
        "note": "string",
        "reviewed_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "reviewed_at": "2026-10-06T05:30:00.000Z",
        "scan_status": "string"
      }
    ],
    "document_counts": {
      "approved": 0,
      "pending": 0,
      "rejected": 0
    },
    "document_kinds": [
      "sale_deed"
    ],
    "min_documents": 0,
    "visitors": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      }
    ],
    "grant_refusal": "string",
    "can": {
      "capture": true,
      "add_documents": true,
      "submit": true,
      "cancel": true,
      "review_documents": true,
      "decide": true,
      "send_back": true,
      "confirm_location": true,
      "open_documents": true,
      "revoke": 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/properties/{id}/verification

A listing’s badge, open verification and history

Everyone who sees the listing gets its badge; the verifications need the verify or review permission.

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

Parameters

idpathrequired: Id
Opaque record id.

Response · 200

datarequired: ListingVerificationOverview
metarequired: object

Request

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

Response example

{
  "data": {
    "enabled": true,
    "badge": {
      "status": "verified",
      "verified_at": "2026-10-06T05:30:00.000Z",
      "expires_at": "2026-10-06T05:30:00.000Z",
      "valid_until": "2026-10-06"
    },
    "current": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "property_id": "cmusrceel0000q7kaafxqi1om",
      "status": "draft",
      "method": "string",
      "visit_result": "fail",
      "started_by": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "started_at": "2026-10-06T05:30:00.000Z",
      "visit_started_at": "2026-10-06T05:30:00.000Z",
      "visit_ended_at": "2026-10-06T05:30:00.000Z",
      "submitted_at": "2026-10-06T05:30:00.000Z",
      "submitted_by": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "return_note": "string",
      "reviewed_by": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "reviewed_at": "2026-10-06T05:30:00.000Z",
      "review_note": "string",
      "self_reviewed": true,
      "verified_at": "2026-10-06T05:30:00.000Z",
      "expires_at": "2026-10-06T05:30:00.000Z",
      "valid_until": "2026-10-06",
      "ended_at": "2026-10-06T05:30:00.000Z",
      "end_reason": "string",
      "end_note": "string"
    },
    "history": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "property_id": "cmusrceel0000q7kaafxqi1om",
        "status": "draft",
        "method": "string",
        "visit_result": "fail",
        "started_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "started_at": "2026-10-06T05:30:00.000Z",
        "visit_started_at": "2026-10-06T05:30:00.000Z",
        "visit_ended_at": "2026-10-06T05:30:00.000Z",
        "submitted_at": "2026-10-06T05:30:00.000Z",
        "submitted_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "return_note": "string",
        "reviewed_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "reviewed_at": "2026-10-06T05:30:00.000Z",
        "review_note": "string",
        "self_reviewed": true,
        "verified_at": "2026-10-06T05:30:00.000Z",
        "expires_at": "2026-10-06T05:30:00.000Z",
        "valid_until": "2026-10-06",
        "ended_at": "2026-10-06T05:30:00.000Z",
        "end_reason": "string",
        "end_note": "string"
      }
    ],
    "can": {
      "start": true,
      "review": true,
      "revoke": 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/properties/{id}/verification

Start (or continue) a verification visit

Opens a verification with the company’s checklist and distance rule — or returns the open one (200).

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

Parameters

idpathrequired: Id
Opaque record id.

Response · 201

datarequired: ListingVerificationDetail
metarequired: object

Request

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

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "property_id": "cmusrceel0000q7kaafxqi1om",
    "status": "draft",
    "method": "string",
    "visit_result": "fail",
    "started_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "started_at": "2026-10-06T05:30:00.000Z",
    "visit_started_at": "2026-10-06T05:30:00.000Z",
    "visit_ended_at": "2026-10-06T05:30:00.000Z",
    "submitted_at": "2026-10-06T05:30:00.000Z",
    "submitted_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "return_note": "string",
    "reviewed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "reviewed_at": "2026-10-06T05:30:00.000Z",
    "review_note": "string",
    "self_reviewed": true,
    "verified_at": "2026-10-06T05:30:00.000Z",
    "expires_at": "2026-10-06T05:30:00.000Z",
    "valid_until": "2026-10-06",
    "ended_at": "2026-10-06T05:30:00.000Z",
    "end_reason": "string",
    "end_note": "string",
    "listing": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "ref_code": "string",
      "title": "string",
      "listing_type": "string",
      "status": "string",
      "city": "string",
      "society_name": "string",
      "building": "string",
      "unit_no": "string",
      "address": "string",
      "pincode": "string",
      "latitude": 0,
      "longitude": 0,
      "location_precision": "exact",
      "pinned": true,
      "owner_name": "string"
    },
    "rule": {
      "radius_m": 0,
      "max_accuracy_m": 0
    },
    "checklist": [
      {
        "key": "string",
        "label": "string",
        "required": true,
        "hint": "string"
      }
    ],
    "evaluation": {
      "result": "fail",
      "reasons": [
        {
          "code": "string",
          "severity": "fail",
          "slot": "string",
          "photo_id": "cmusrceel0000q7kaafxqi1om",
          "text": "string"
        }
      ],
      "centre": {
        "lat": 0,
        "lng": 0
      },
      "against": "listing",
      "missing": [
        "string"
      ]
    },
    "location_confirmed_at": "2026-10-06T05:30:00.000Z",
    "location_confirmed_by": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string"
    },
    "photos": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "slot": "string",
        "status": "processing",
        "failure": "string",
        "preview_url": "string",
        "preview_expires_at": "2026-10-06T05:30:00.000Z",
        "width": 0,
        "height": 0,
        "captured_at": "2026-10-06T05:30:00.000Z",
        "captured_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "time_source": "string",
        "device": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "device_fix_at": "2026-10-06T05:30:00.000Z",
        "exif": {
          "lat": 0,
          "lng": 0,
          "accuracy_m": 0
        },
        "exif_taken_at": "2026-10-06T05:30:00.000Z",
        "exif_time_source": "string",
        "distance_m": 0,
        "result": "pending",
        "flags": [
          {
            "code": "string",
            "severity": "fail",
            "text": "string"
          }
        ]
      }
    ],
    "replaced_photos": 0,
    "documents": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "kind": "string",
        "kind_label": "string",
        "status": "pending",
        "filename": "string",
        "content_type": "string",
        "size_bytes": 0,
        "uploaded_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "uploaded_at": "2026-10-06T05:30:00.000Z",
        "name_match": "match",
        "address_match": "match",
        "document_date": "2026-10-06",
        "note": "string",
        "reviewed_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "reviewed_at": "2026-10-06T05:30:00.000Z",
        "scan_status": "string"
      }
    ],
    "document_counts": {
      "approved": 0,
      "pending": 0,
      "rejected": 0
    },
    "document_kinds": [
      "sale_deed"
    ],
    "min_documents": 0,
    "visitors": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      }
    ],
    "grant_refusal": "string",
    "can": {
      "capture": true,
      "add_documents": true,
      "submit": true,
      "cancel": true,
      "review_documents": true,
      "decide": true,
      "send_back": true,
      "confirm_location": true,
      "open_documents": true,
      "revoke": 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/properties/{id}/verification/revoke

Revoke a listing’s Verified badge

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

Parameters

idpathrequired: Id
Opaque record id.

Request body

reasonrequired: string

Response · 200

datarequired: ListingVerificationOverview
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/properties/{id}/verification/revoke' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"reason":"string"}'

Response example

{
  "data": {
    "enabled": true,
    "badge": {
      "status": "verified",
      "verified_at": "2026-10-06T05:30:00.000Z",
      "expires_at": "2026-10-06T05:30:00.000Z",
      "valid_until": "2026-10-06"
    },
    "current": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "property_id": "cmusrceel0000q7kaafxqi1om",
      "status": "draft",
      "method": "string",
      "visit_result": "fail",
      "started_by": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "started_at": "2026-10-06T05:30:00.000Z",
      "visit_started_at": "2026-10-06T05:30:00.000Z",
      "visit_ended_at": "2026-10-06T05:30:00.000Z",
      "submitted_at": "2026-10-06T05:30:00.000Z",
      "submitted_by": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "return_note": "string",
      "reviewed_by": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string"
      },
      "reviewed_at": "2026-10-06T05:30:00.000Z",
      "review_note": "string",
      "self_reviewed": true,
      "verified_at": "2026-10-06T05:30:00.000Z",
      "expires_at": "2026-10-06T05:30:00.000Z",
      "valid_until": "2026-10-06",
      "ended_at": "2026-10-06T05:30:00.000Z",
      "end_reason": "string",
      "end_note": "string"
    },
    "history": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "property_id": "cmusrceel0000q7kaafxqi1om",
        "status": "draft",
        "method": "string",
        "visit_result": "fail",
        "started_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "started_at": "2026-10-06T05:30:00.000Z",
        "visit_started_at": "2026-10-06T05:30:00.000Z",
        "visit_ended_at": "2026-10-06T05:30:00.000Z",
        "submitted_at": "2026-10-06T05:30:00.000Z",
        "submitted_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "return_note": "string",
        "reviewed_by": {
          "id": "cmusrceel0000q7kaafxqi1om",
          "name": "string"
        },
        "reviewed_at": "2026-10-06T05:30:00.000Z",
        "review_note": "string",
        "self_reviewed": true,
        "verified_at": "2026-10-06T05:30:00.000Z",
        "expires_at": "2026-10-06T05:30:00.000Z",
        "valid_until": "2026-10-06",
        "ended_at": "2026-10-06T05:30:00.000Z",
        "end_reason": "string",
        "end_note": "string"
      }
    ],
    "can": {
      "start": true,
      "review": true,
      "revoke": 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/settings/listing-verification