Saltar al contenido principal
GET
Obtén una cita de extracción de sangre por su UUID, incluido el perfil del paciente integrado. Usa este endpoint para comprobar el estado de la cita, confirmar los detalles de la reserva u obtener los datos del perfil asociado. Requiere el scope appointments_view o appointments_schedule.

Solicitud

Parámetros de ruta

string
requerido
Identificador único (UUID) de la cita que quieres obtener.

Respuesta

Si la solicitud tiene éxito, la API devuelve 200 OK con la cita y su perfil integrado.
string
requerido
Identificador único de la cita (UUID).
string
requerido
UUID del perfil al que pertenece esta cita.
string
UUID del centro de análisis donde se realiza la extracción de sangre.
string
Fecha y hora programadas de la cita como instante UTC (ISO 8601 con sufijo Z, p. ej., 2026-05-15T10:30:00Z). Puede ser null.
string
requerido
Estado actual de la cita. Puede ser pending, confirmed, blood_drawn o cancelled. El grado de avance de los resultados de laboratorio se obtiene en Obtener resultados; el progreso detallado de los envíos, a partir de cada entrada del array shipments integrado (ver más abajo) consultándolo en Obtener envío.
string
Motivo en texto libre registrado al cancelar la cita (p. ej., no presentado, cancelación tardía, ‘Fallida. Repetición necesaria’). null salvo que status sea cancelled.
string[]
requerido
Direcciones que reciben un correo cada una cuando todos los resultados de laboratorio son definitivos, en minúsculas. Vacío cuando está desactivado. Consulta Correos de resultados listos.
string
requerido
Cómo se realiza la extracción de sangre: capillary (en la yema del dedo o en la parte superior del brazo, en microtubos) o venous (de la vena, en tubos). Es el método definido en la cita o, en su defecto, el default_draw_method de su ubicación. Después de la extracción de sangre, es el método que se utilizó.
string
requerido
Marca de tiempo ISO 8601 de cuándo se creó la cita.
string
Marca de tiempo ISO 8601 de la última actualización. Puede ser null.
object
requerido
El perfil del paciente asociado a esta cita.
AppointmentPanel[]
requerido
Paneles asociados actualmente a esta cita. Excluye las asociaciones canceladas. Consulta los detalles del panel (nombre, biomarcadores) mediante Listar paneles.
AppointmentIndividualBiomarker[]
requerido
Biomarcadores a la carta asociados a esta cita fuera de cualquier panel (consulta Añadir biomarcadores personalizados). Contrasta cada biomarker_id con Listar biomarcadores para obtener los datos de visualización.
AppointmentShipmentLink[]
requerido
Envíos vinculados a esta cita, del vínculo más antiguo al más reciente. Array vacío cuando no hay envíos vinculados. Cruza cada id con Obtener envío para ver los datos completos del envío (estado, número de seguimiento, actualizaciones de estado, etc.).
string[]
requerido
Códigos de laboratorio (códigos de barras de los tubos) registrados para esta cita, en orden de escaneo. Vacío hasta que se confirme la extracción de sangre. Una extracción venosa lleva un único código impreso en todos los tubos; una extracción capilar lleva un código por microtubo. Los resultados y documentos de Obtener resultados hacen referencia a estos códigos mediante lab_code.

Llamadas repetidas

Aniva almacena la respuesta de este endpoint durante 15 minutos para cada clave de API. Una llamada repetida dentro de este plazo recibe la respuesta almacenada mientras la cita no cambie. Tras un cambio, recibes una respuesta nueva. Las cabeceras Cache-Status y Age muestran que la respuesta está almacenada y cuál es su antigüedad. Para enterarte de un cambio al instante, suscríbete a los eventos de webhook appointment.created, appointment.rescheduled y al evento de cada estado, por ejemplo appointment.confirmed. Consulta Lecturas repetidas.

Respuestas de error