A property's detail by its propertyId, with exactly the same shape as GET /api/action/express-v1/properties/{propertyHash}.
It exists for a concrete reason: properties/sitemap returns the propertyId and not the hash, so this is the service that lets you open the listing a visitor found through the sitemap.
| Resource information | |
|---|---|
| Authentication | Required (API Token, Bearer) |
| Scope | express-base |
| HTTP Method | GET |
| Response | JSON |
| Version | 1 |
Resource URL
https://mapaprop.app/api/action/express-v1/properties/id/{propertyId}
Parameters
| Key | Type | Required | Description |
|---|---|---|---|
| propertyId | integer | yes | The property id, in the URL. It must be an integer greater than 0 |
Sample code
GET /api/action/express-v1/properties/id/257007 HTTP/1.1
Host: mapaprop.app
Authorization: Bearer {access_token}
Response
The same as the read by hash: the property object, with its attributes filtered, its videos, its branch and the type and operation with their description. Like that read, it records a visit to the property.
| Case | Response |
|---|---|
| The property exists and belongs to your account | 200 with the property object |
| It does not exist, or does not belong to your account | 404 with {"success": false, "message": "Property not found"} |
| The id is not an integer greater than 0 | 400 with INVALID_INPUT or INVALID_NUMBER |
Sample error response
{
"success": false,
"message": "Property not found"
}
Unpublished properties are not returned, same as in every other read service.