Retrieve a property

Return one property of the public catalogue by its ID.

GET/v1/ext/properties/{property_id}

On this page

When a property is not found
Example request
Authorization
Path parameters
Response
Errors

Returns the same property object as List properties. Use it to render a listing page or to refresh one property after a change.

When a property is not found

404 Property not found is returned when the ID does not exist, but also when the property exists and is not part of the public catalogue: it is not marked as public, it is sold, rented or withdrawn, or it belongs to another workspace. The response does not say which, so a listing that disappears from your site should simply be removed.

Example request

curl "https://api.vestta.app/v1/ext/properties/1355" \
  -H "X-Api-Key: $VESTTA_API_KEY"

Authorization

X-Api-Keystringheaderrequired
Your API key, AC_LIVE_<key_id>.<secret>. Authorization: ApiKey <key> is also accepted.

Path parameters

property_idintegerrequired≥ 1
Numeric property ID, as returned in data[].id by List properties.

Response

200 Successful response.

Example response

{
  "status": "ok",
  "data": {
    "id": 1355,
    "operation": "traspaso,alquiler",
    "type": "local",
    "subtype": "Local Comercial",
    "title": "Local comercial en el centro",
    "price": 0,
    "size_total": 120,
    "bedrooms": 0,
    "bathrooms": 1,
    "postal_code": "07820",
    "description": "<h2>Características del local</h2><p>Superficie total de 120 m² en planta baja…</p>",
    "images": [
      {
        "id": "63cfd9acfb62c728a6721ca0dd4afdcb_1784627270",
        "is_primary": true,
        "order": 1,
        "url": "https://cdn.vestta.app/images/caa459b11e9f/73121a89c611/63cfd9acfb62c728a6721ca0dd4afdcb_1784627270.jpeg"
      }
    ],
    "videos": [],
    "specs": {
      "address_privacy": "approximate",
      "holiday_renting": false,
      "price_calc": {
        "price_alq": 2000,
        "price_trasp": 25000
      },
      "temporal_renting": false
    },
    "features": [
      {
        "isextra": false,
        "key": "air_conditioning",
        "label": "Aire Acondicionado",
        "value": "Sí"
      }
    ],
    "status": "disponible",
    "address": "San Antonio",
    "city": "San Antonio",
    "province": "Islas Baleares",
    "country": "España",
    "lat": 38.98,
    "lon": 1.3,
    "is_featured": false,
    "created_at": "2026-07-21T11:42:51.820440+02:00",
    "updated_at": "2026-09-26T19:38:41.390976+02:00"
  }
}

Response fields

statusstringrequired always ok
dataExternalPropertyrequired
- idintegerrequired
  Numeric property ID. Use it with Retrieve a property.
- operationstring
  Operations the property is offered for: venta, alquiler, traspaso, or several joined by commas (e.g. venta,alquiler).
- typestring
  Property type key, e.g. apartamento, casa, local, oficina, terreno or edificio.
- subtypestring
  Subtype as a Spanish display label (e.g. Ático, Local Comercial), or Sin Especificar.
- titlestring
  Listing title. May be empty.
- pricenumber
  Sale price in euros. Rent and transfer prices are in specs.price_calc.
- size_totalnumber
  Total size in m².
- bedroomsinteger
- bathroomsinteger
- postal_codestring
  Omitted when the property's location is hidden.
- descriptionstring
  Listing description as HTML.
- imagesarray of any
  Public images, as {id, url, order, is_primary, title} objects.
- videosarray of any
  Processed videos, as {id, title, order, url, hls_url, thumbnail_url, embed_url} objects.
- specsobject
  Listing characteristics. Keys depend on the property type. price_calc.price_alq and price_calc.price_trasp hold the monthly rent and transfer price; address_privacy is public, approximate or hidden; building_name is only present when the address is public.
- featuresarray of any
  Amenities as {label, key, value, isextra} objects. label is a display string; key is stable.
- statusstring
  disponible or reservada. Sold, rented and withdrawn properties are never returned.
- addressstring
  Follows the property's address privacy: the full address when public, the approximate address when approximate, omitted when hidden.
- citystring
- provincestring
- countrystring
- latnumber
  Latitude in decimal degrees. Exact when the address is public, rounded to 2 decimals (about 1 km) when approximate, omitted when hidden.
- lonnumber
  Longitude in decimal degrees, with the same precision rules as lat.
- is_featuredboolean
  Whether the business marked the property as featured.
- created_atstring
  ISO 8601 timestamp with UTC offset.
- updated_atstring
  ISO 8601 timestamp with UTC offset. The default sort key.

Errors

Status	When
401 Unauthorized	The API key is missing, malformed, unknown, revoked or expired, or lacks the required scope.
404 Not Found	The property does not exist, is not public, or is sold, rented or withdrawn.
422 Unprocessable Content	A path parameter, query parameter or body field is invalid.
500 Internal Server Error	Unexpected server error while processing the request.

Error bodies and how to handle each case: Errors.