Skip to main content
GET
/
destinos
curl https://api.tesisrutas.com/destinos

{
  "total": 2,
  "data": [
    {
      "_id": "507f1f77bcf86cd799439011",
      "nombre": "Catedral de Lima",
      "ubicacion": "Plaza Mayor, Lima Centro",
      "importancia": "Principal templo católico del Perú, construcción colonial",
      "coordenadas": {
        "latitud": -12.046374,
        "longitud": -77.030090
      },
      "anio_construccion": [1535, 1649],
      "arquitecto": "Francisco Becerra",
      "area_construccion": 8900,
      "funcion": "Templo religioso y sede arquidiocesana",
      "multimedia": [
        {
          "url": "https://res.cloudinary.com/.../cathedral_front.jpg",
          "public_id": "destinations/507f1f77bcf86cd799439011/cathedral_front",
          "tipo": "image",
          "formato": "jpg",
          "tamanio_bytes": 2456789,
          "anchura": 1920,
          "altura": 1080
        }
      ],
      "fecha_creacion": "2024-01-15T10:30:00.000Z",
      "activo": true
    },
    {
      "_id": "507f1f77bcf86cd799439012",
      "nombre": "Convento de San Francisco",
      "ubicacion": "Jr. Ancash 471, Lima",
      "importancia": "Complejo religioso colonial con catacumbas históricas",
      "coordenadas": {
        "latitud": -12.046100,
        "longitud": -77.028500
      },
      "anio_construccion": [1546],
      "arquitecto": null,
      "area_construccion": null,
      "funcion": "Museo y templo religioso",
      "multimedia": [],
      "fecha_creacion": "2024-01-16T14:22:00.000Z",
      "activo": true
    }
  ]
}

​
Authentication

Required Role: None (Public endpoint) This endpoint is publicly accessible and does not require authentication.

​
Response

​
total
number
Total count of active destinations
​
data
array
Array of destination objects
​
data[]._id
string
MongoDB ObjectId of the destination
​
data[].nombre
string
Name of the heritage site
​
data[].ubicacion
string
Location or address
​
data[].importancia
string
Historical or cultural significance
​
data[].coordenadas
object
Geographic coordinates
​
data[].coordenadas.latitud
number
Latitude
​
data[].coordenadas.longitud
number
Longitude
​
data[].anio_construccion
array
Year(s) of construction (1 or 2 values)
​
data[].arquitecto
string
Architect name (if available)
​
data[].area_construccion
number
Construction area in square meters (if available)
​
data[].funcion
string
Function of the site (if available)
​
data[].multimedia
array
Array of multimedia files associated with this destination
​
data[].multimedia[].url
string
Cloudinary secure URL for the file
​
data[].multimedia[].public_id
string
Cloudinary public ID
​
data[].multimedia[].tipo
string
File type: “image” or “video”
​
data[].multimedia[].formato
string
File format (e.g., “jpg”, “png”, “mp4”)
​
data[].multimedia[].tamanio_bytes
number
File size in bytes
​
data[].multimedia[].anchura
number
Width in pixels (for images/videos)
​
data[].multimedia[].altura
number
Height in pixels (for images/videos)
​
data[].multimedia[].duracion
number
Duration in seconds (for videos only)
​
data[].fecha_creacion
string
ISO 8601 timestamp of creation
​
data[].activo
boolean
Always true (only active destinations are returned)
curl https://api.tesisrutas.com/destinos

{
  "total": 2,
  "data": [
    {
      "_id": "507f1f77bcf86cd799439011",
      "nombre": "Catedral de Lima",
      "ubicacion": "Plaza Mayor, Lima Centro",
      "importancia": "Principal templo católico del Perú, construcción colonial",
      "coordenadas": {
        "latitud": -12.046374,
        "longitud": -77.030090
      },
      "anio_construccion": [1535, 1649],
      "arquitecto": "Francisco Becerra",
      "area_construccion": 8900,
      "funcion": "Templo religioso y sede arquidiocesana",
      "multimedia": [
        {
          "url": "https://res.cloudinary.com/.../cathedral_front.jpg",
          "public_id": "destinations/507f1f77bcf86cd799439011/cathedral_front",
          "tipo": "image",
          "formato": "jpg",
          "tamanio_bytes": 2456789,
          "anchura": 1920,
          "altura": 1080
        }
      ],
      "fecha_creacion": "2024-01-15T10:30:00.000Z",
      "activo": true
    },
    {
      "_id": "507f1f77bcf86cd799439012",
      "nombre": "Convento de San Francisco",
      "ubicacion": "Jr. Ancash 471, Lima",
      "importancia": "Complejo religioso colonial con catacumbas históricas",
      "coordenadas": {
        "latitud": -12.046100,
        "longitud": -77.028500
      },
      "anio_construccion": [1546],
      "arquitecto": null,
      "area_construccion": null,
      "funcion": "Museo y templo religioso",
      "multimedia": [],
      "fecha_creacion": "2024-01-16T14:22:00.000Z",
      "activo": true
    }
  ]
}

​
Implementation Details

This endpoint:
  1. Queries the sitios_patrimoniales collection with filter {"activo": true}
  2. Returns only destinations marked as active
  3. Converts MongoDB ObjectIds to strings for JSON serialization
  4. Includes all associated multimedia files in the response
Filter Behavior:
  • Only destinations with activo: true are returned
  • Deactivated destinations (toggled via /estado/{id}) are excluded
  • No pagination is currently implemented
Source: destinos_router.py:30-34

Build docs developers (and LLMs) love

Get started for freeTalk to us