GET /api/levantamientos — List Damage Survey Records

List all damage surveys stored in Monitor API, optionally filtered by claim number. Results are returned in descending order by id (most recent first) and always include nested cost concepts.

Endpoint

GET /api/levantamientos

All requests must include a valid Bearer token. Any authenticated role (Administrador, Operador, Tecnico) may call this endpoint.

Query Parameters

no_siniestro

string

Filter results to levantamientos linked to this siniestro number. When omitted, all records are returned. The value must match the no_siniestro field on an existing expediente.Example: SIN-2024-001

Request Examples

# List all levantamientos
curl http://localhost:3000/api/levantamientos \
  -H "Authorization: Bearer $TOKEN"

# Filter by siniestro number
curl "http://localhost:3000/api/levantamientos?no_siniestro=SIN-2024-001" \
  -H "Authorization: Bearer $TOKEN"

Response

200 — Success

Returns an array of levantamiento objects. The array is empty ([]) when no records match the filter.

[
  {
    "id": 42,
    "no_siniestro": "SIN-2024-001",
    "fecha": "2024-01-15T12:00:00.000Z",
    "orden": "ORD-0042",
    "marca": "Toyota",
    "tipo": "Sedán",
    "modelo": "Corolla",
    "placas": "ABC-1234",
    "kilometraje": "84500",
    "no_puertas": "4",
    "color": "Blanco",
    "serie": "1HGBH41JXMN109186",
    "eco": "ECO-042",
    "asegurado_tercero": "Asegurado",
    "nombre_propietario": "Juan Pérez",
    "telefono": "5551234567",
    "direccion": "Calle Reforma 123, CDMX",
    "pega": null,
    "cristales": true,
    "aire": false,
    "vestiduras": false,
    "rin": false,
    "direccion_veh": false,
    "tipo_pintura": true,
    "trasmision": false,
    "levantamiento_concepto": [
      {
        "id": 7,
        "id_levantamiento": 42,
        "claves": "CR-001",
        "concepto": "Cambio de parabrisas",
        "costo": "3500.00"
      }
    ]
  }
]

Show Response fields

integer

Auto-incremented primary key for the levantamiento.

no_siniestro

string | null

The claim number this survey is linked to. References an expediente.no_siniestro.

fecha

string | null

Date the survey was conducted, stored as a PostgreSQL Date and serialized as an ISO 8601 timestamp.

orden

string | null

Internal work order reference.

marca

string | null

Vehicle make, e.g. "Toyota".

tipo

string | null

Vehicle body type, e.g. "Sedán" or "SUV".

modelo

string | null

Vehicle model name, e.g. "Corolla".

placas

string | null

License plate number.

kilometraje

string | null

Odometer reading at the time of the survey.

no_puertas

string | null

Number of doors, stored as a string, e.g. "4".

color

string | null

Vehicle color.

serie

string | null

Vehicle identification number (VIN / número de serie).

eco

string | null

Internal economic number assigned to the vehicle.

asegurado_tercero

string | null

Whether the claim is for the policy holder or a third party. Typical values: "Asegurado", "Tercero".

nombre_propietario

string | null

Full name of the vehicle owner.

telefono

string | null

Contact phone number of the vehicle owner.

direccion

string | null

Address of the vehicle owner.

pega

string | null

Auxiliary field for sticker or label reference.

cristales

boolean | null

Indicates glass / windshield damage.

aire

boolean | null

Indicates air conditioning system damage.

vestiduras

boolean | null

Indicates upholstery damage.

rin

boolean | null

Indicates wheel rim damage.

direccion_veh

boolean | null

Indicates steering system damage.

tipo_pintura

boolean | null

Indicates paint type or paint damage flag.

trasmision

boolean | null

Indicates transmission damage.

levantamiento_concepto

array

Array of itemized repair cost concepts attached to this survey. See Conceptos for details on the shape of each item.

Error Responses

Status	Description
`401`	Missing or invalid `Authorization` header.
`500`	Unexpected server error.

Authentication

Expedientes

Evidencias

Levantamiento de Daños

Users & Health

GET /api/levantamientos — List Damage Survey Records

Endpoint

Query Parameters

Request Examples

Response

200 — Success

Error Responses

Build docs developers (and LLMs) love

Authentication

Expedientes

Evidencias

Levantamiento de Daños

Users & Health

Documentation Index

​Endpoint

​Query Parameters

​Request Examples

​Response

​200 — Success

​Error Responses

Build docs developers (and LLMs) love

Endpoint

Query Parameters

Request Examples

Response

200 — Success

Error Responses