GET /api/properties/:id — Fetch a Single Property

The GET /api/properties/:id endpoint retrieves a single property listing by its unique UUID identifier. No authentication is required. The response wraps the property data inside a property key. If no record matching the provided id exists in the properties table, the server responds with a 500 error containing a descriptive message.

Endpoint

GET /api/properties/:id

Authentication

None required. This is a public endpoint.

Path Parameters

string

required

The UUID of the property to retrieve. Must exactly match a record in the properties table. UUIDs are generated server-side when a property is created with POST /api/properties.

Response

On success, the endpoint returns a JSON object with a property key containing the full property record.

Response Fields

property

object

required

The full property object for the requested listing.

Show property fields

string

Unique UUID identifier for the property.

title

string

Short descriptive title of the property listing.

description

string

Longer free-text description of the property.

status

string

Listing availability status. One of Venta, Alquiler, or Ambas.

property_type

string

Category of the property. One of Casa, Apartamento, Terreno, or Comercial.

address

string

Street address of the property.

city

string

City where the property is located.

state

string

State or region where the property is located.

price

number

Listed price of the property.

bedrooms

number

Number of bedrooms.

bathrooms

number

Number of bathrooms.

square_feet

number

Total area in square feet.

parking_lots

number

Number of parking spaces.

img_url

string

URL of the property’s primary image. May be null.

user_id

string

UUID of the user who created the listing.

Error Responses

Status	Body	Description
`500`	`{ "error": "Propiedad no encontrada en la base de datos" }`	No property record with the given `id` exists.

Example

Request

curl --request GET \
  --url https://your-api-domain.com/api/properties/a1b2c3d4-e5f6-7890-abcd-ef1234567890

Success Response

{
  "property": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "title": "Apartamento moderno en Las Mercedes",
    "description": "Apartamento de un dormitorio con vista a la ciudad.",
    "status": "Alquiler",
    "property_type": "Apartamento",
    "address": "Av. Las Mercedes, Torre Cristal, Piso 8",
    "city": "Caracas",
    "state": "Distrito Capital",
    "price": 800,
    "bedrooms": 1,
    "bathrooms": 1,
    "square_feet": 650,
    "parking_lots": 1,
    "img_url": "https://example.com/images/apt-mercedes.jpg",
    "user_id": "f7e6d5c4-b3a2-1098-fedc-ba9876543210"
  }
}

Error Response

{
  "error": "Propiedad no encontrada en la base de datos"
}

Users

Properties

Data Models

GET /api/properties/:id — Fetch a Single Property

Endpoint

Authentication

Path Parameters

Response

Response Fields

Error Responses

Example

Request

Success Response

Error Response

Build docs developers (and LLMs) love

Users

Properties

Data Models

Documentation Index

​Endpoint

​Authentication

​Path Parameters

​Response

​Response Fields

​Error Responses

​Example

​Request

​Success Response

​Error Response

Build docs developers (and LLMs) love

Endpoint

Authentication

Path Parameters

Response

Response Fields

Error Responses

Example

Request

Success Response

Error Response