Skip to content
VesttaDocs
VesttaDocs
API Reference Vestta

Loading…

Retrieve a property

Return one property of the public catalogue by its ID.

GET/v1/properties/{property_id}

Requires the properties:read scope

On this page

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 still a draft, or it belongs to another workspace. Commercial status does not override explicit publication. 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/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

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": "7eac604ad45147d19c7cedb2a10569aa",
        "url": "https://cdn.vestta.app/media/7eac604ad45147d19c7cedb2a10569aa.webp",
        "order": 1,
        "is_primary": true
      }
    ],
    "videos": [],
    "specs": {
      "holiday_renting": false,
      "temporal_renting": false,
      "address_privacy": "approximate",
      "price_calc": {
        "price_alq": 2000,
        "price_trasp": 25000
      }
    },
    "features": [
      {
        "key": "air_conditioning",
        "label": "Aire Acondicionado",
        "value": "Sí",
        "isextra": false
      }
    ],
    "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

Errors

StatusWhen
401 UnauthorizedThe API key is missing, malformed, unknown, revoked or expired.
403 ForbiddenThe API key lacks the required scope.
404 Not FoundThe resource does not exist in this business.
409 ConflictDuplicate contact or idempotency key reused with a different payload.
422 Unprocessable ContentA path parameter, query parameter or body field is invalid.
500 Internal Server ErrorUnexpected server error while processing the request.

Error bodies and how to handle each case: Errors.