Referencia · Reservas

Estado de una reserva hecha por la API

GET /api/v1/reservas/{compraId}

GET/api/v1/reservas/{compraId}

Scope reservas:leer, solo clave secreta. Solo reservas creadas por la API v1 de este negocio.

Autenticación: Authorization: Bearer <clave>. Ver Autenticación.

Parámetros

Nombre	En	Tipo	Obligatorio	Descripción
`compraId`	path	string	Sí

Ejemplo

curl "https://turnovapp.com/api/v1/reservas/cmh4k2n9x0001" \
  -H "Authorization: Bearer $TURNOVA_CLAVE_SECRETA"

Respuestas

HTTP	Qué significa
200	Estado
401	Clave faltante, inválida o revocada.
403	Origen no permitido, permiso faltante, clave secreta desde un navegador o plan sin la API (`PLAN_SIN_API`).
404	No existe o no es de este negocio.
429	Demasiados pedidos (`LIMITE_USO`): esperá `Retry-After` segundos.
500	Error técnico: reintentá con los mismos datos (y la misma `Idempotency-Key`).

Respuesta 200

{
  "version": 1,
  "ok": true,
  "progreso": {
    "principal": "CONSULTADO"
  },
  "requiereRevision": false,
  "datos": {
    "compraId": "cmh4k2n9x0001",
    "total": 25000,
    "estadoPago": "SIN_SENA",
    "sena": {
      "monto": 6250,
      "checkoutUrl": "https://www.mercadopago.com.ar/checkout/v1/redirect?pref_id=123456-abcd"
    },
    "turnos": [
      {
        "turnoId": "cmh4k2pa10003",
        "estado": "CONFIRMADO"
      }
    ]
  }
}

Campo	Tipo	Obligatorio	Descripción
`datos.compraId`	string	No
`datos.total`	number	No
`datos.estadoPago`	`SIN_SENA`, `PAGADA`, `PENDIENTE`, `VENCIDA`, `EN_EL_LOCAL`, `EN_REVISION`	No
`datos.sena`	object o null	No
`datos.sena.monto`	number	No
`datos.sena.checkoutUrl`	string o null	No	Solo mientras la seña está PENDIENTE.
`datos.turnos`	array de object	No
`datos.turnos[].turnoId`	string	No
`datos.turnos[].estado`	string	No

Los errores siguen el formato común: ver Errores.