> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancelar cita

> Cancelar una cita de extracción de sangre

Cancela una cita estableciendo su estado en `cancelled`. Solo se pueden cancelar las citas cuya extracción de sangre aún no se haya confirmado.

Cancelar una cita que ya está en estado `cancelled` devuelve `200` con esa cita y no escribe nada: no se registra una segunda cancelación. La respuesta incluye `Idempotent-Replayed: true` para que puedas distinguir una repetición de la llamada que realizó la operación. En cambio, una repetición con un `cancellation_reason` **diferente** devuelve `409`: el motivo registrado nunca se sobrescribe. Consulta [Idempotencia](https://docs.anivahealth.com/es/concepts/idempotency.md).

> [!WARNING]
>
> No se pueden cancelar citas después de confirmar la extracción de sangre: eso devuelve `409
>     Conflict`.

Requiere el scope `appointments_schedule` o `appointments_manage`.

## Solicitud

### Parámetros de ruta

**id** `string` *required*

Identificador único (UUID) de la cita que quieres cancelar.

### Parámetros del cuerpo

El cuerpo es opcional: no envíes ningún cuerpo para cancelar sin registrar un motivo.

**cancellation\_reason** `string`

Motivo de cancelación en texto libre, de hasta 500 caracteres (p. ej., `Patient no-show`). Se guarda en
la cita y se devuelve como `cancellation_reason` en esta y en posteriores lecturas.

## Respuesta

Si tiene éxito, la API devuelve `200 OK` con la cita cancelada y su perfil incrustado.

**id** `string` *required*

Identificador único de la cita (UUID).

**profile\_id** `string` *required*

UUID del perfil al que pertenece esta cita.

**location\_id** `string`

UUID del centro de análisis donde se realiza la extracción de sangre.

**scheduled\_at** `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`.

**status** `string` *required*

Estado de la cita. Será `cancelled` tras una cancelación correcta.

**cancellation\_reason** `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`.

**results\_ready\_emails** `string[]` *required*

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](https://docs.anivahealth.com/es/concepts/results.md#correos-de-resultados-listos).

**draw\_method** `string` *required*

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](https://docs.anivahealth.com/es/concepts/locations.md). Después de la extracción de sangre, es el método que se utilizó.

**created\_at** `string` *required*

Marca de tiempo ISO 8601 de cuándo se creó la cita.

**updated\_at** `string`

Marca de tiempo ISO 8601 de la última actualización. Puede ser `null`.

**profile** `object` *required*

El perfil del paciente asociado a esta cita.

**perfil**

**id** `string`

Identificador único del perfil (UUID).

**handle** `string`

Alias o nombre de usuario del perfil. Puede ser `null`.

**first\_name** `string`

Nombre. Puede ser `null`.

**last\_name** `string`

Apellido. Puede ser `null`.

**email** `string`

Dirección de correo electrónico. Puede ser `null`.

**phone** `string`

Número de teléfono en formato E.164. Puede ser `null`.

**sex** `integer`

Sexo biológico según ISO/IEC 5218. Puede ser `null`.

**date\_of\_birth** `string`

Fecha de nacimiento en formato `YYYY-MM-DD`. Puede ser `null`.

**height** `number`

Altura en centímetros. Puede ser `null`.

**weight** `number`

Peso en kilogramos. Puede ser `null`.

**language** `string`

Idioma preferido: uno de los 32 códigos en [Crear perfil](https://docs.anivahealth.com/es/api/profiles/create-profile.md).

**transactional\_emails\_enabled** `boolean`

Indica si este perfil recibe correos transaccionales (programáticos). Puede ser `null`.

**created\_at** `string`

Marca de tiempo ISO 8601 de cuándo se creó el perfil.

**updated\_at** `string`

Marca de tiempo ISO 8601 de la última actualización del perfil. Puede ser `null`.

**panels** `AppointmentPanel[]` *required*

Paneles que estaban asociados a esta cita antes de la cancelación. Consulta los detalles del panel (nombre,
biomarcadores) mediante [Listar paneles](https://docs.anivahealth.com/es/api/panels/list-panels.md).

**Campos de asociación de panel**

**panel\_id** `string`

UUID del panel: contrástalo con [Listar paneles](https://docs.anivahealth.com/es/api/panels/list-panels.md).

**added\_at** `string`

Marca de tiempo ISO 8601 en la que el panel se asoció por primera vez a esta cita.

**individual\_biomarkers** `AppointmentIndividualBiomarker[]` *required*

Biomarcadores a la carta asociados a esta cita fuera de cualquier panel (consulta [Añadir
biomarcadores personalizados](https://docs.anivahealth.com/es/api/appointments/add-individual-biomarkers.md)). Contrasta cada `biomarker_id`
con [Listar biomarcadores](https://docs.anivahealth.com/es/api/biomarkers/list-biomarkers.md) para obtener los datos de visualización.

**Campos de biomarcador individual**

**biomarker\_id** `integer`

Identificador del biomarcador: contrástalo con
[Listar biomarcadores](https://docs.anivahealth.com/es/api/biomarkers/list-biomarkers.md).

**added\_at** `string`

Marca de tiempo ISO 8601 en la que el biomarcador se asoció por primera vez a esta cita.

**shipments** `AppointmentShipmentLink[]` *required*

Envíos que estaban vinculados a esta cita antes de la cancelación. Cada `id` se puede contrastar
con [Obtener envío](https://docs.anivahealth.com/es/api/shipments/get-shipment.md).

**Campos de vínculo de envío**

**id** `string`

Identificador de referencia del envío: contrástalo con
[Obtener envío](https://docs.anivahealth.com/es/api/shipments/get-shipment.md).

**added\_at** `string`

Marca de tiempo ISO 8601 en la que el envío se vinculó por primera vez a esta cita.

**lab\_codes** `string[]` *required*

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](https://docs.anivahealth.com/es/api/appointments/get-results.md) hacen referencia
a estos códigos mediante `lab_code`.

## Respuestas de error

| Estado | Descripción |
| - | - |
| `400` | Formato de ID no válido, cuerpo mal formado o `cancellation_reason` de más de 500 caracteres. |
| `403` | Prohibido: tu clave de API no tiene acceso a esta operación o la cita está fuera de tu contexto de acceso. |
| `404` | Cita no encontrada. |
| `409` | La extracción de sangre ya se ha confirmado o la cita ya está cancelada con un motivo diferente. |
| `500` | Error interno del servidor. |

```bash cURL theme={null}
curl --request DELETE \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a \
  --header 'x-api-key: YOUR_API_KEY'
```

```bash cURL (with a reason) theme={null}
curl --request DELETE \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "cancellation_reason": "Patient no-show"
  }'
```

```json 200 theme={null}
{
  "id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
  "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
  "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
  "scheduled_at": "2026-05-15T10:30:00Z",
  "status": "cancelled",
  "cancellation_reason": "Patient no-show",
  "results_ready_emails": [],
  "draw_method": "venous",
  "created_at": "2026-04-01T09:45:00Z",
  "updated_at": "2026-04-10T12:00:00Z",
  "profile": {
    "id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "handle": null,
    "first_name": "Maria",
    "last_name": "Schmidt",
    "email": "maria.schmidt@example.com",
    "phone": "+4930123456789",
    "sex": 2,
    "date_of_birth": "1985-03-22",
    "height": 168,
    "weight": 65,
    "language": "de",
    "transactional_emails_enabled": true,
    "created_at": "2026-04-01T09:14:32Z",
    "updated_at": null
  },
  "panels": [
    {
      "panel_id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
      "added_at": "2026-04-01T09:50:00Z"
    }
  ],
  "individual_biomarkers": [],
  "shipments": [],
  "lab_codes": []
}
```

```json 409 theme={null}
{
  "error": "This appointment is already cancelled with a different cancellation_reason. Re-send the recorded reason, or omit it, to read the cancelled appointment back."
}
```

```json 404 theme={null}
{
  "error": "Appointment not found"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.