GET

Get Appointment

Retrieves a single appointment by id.

GEThttps://api.vantaxai.com/v1/appointments/{appointment_id}

Headers

Authorizationstringrequired
Bearer authentication with your secret API key.
example: Bearer vx_live_3fa9c2…

Path Parameters

appointment_idstringrequired
The appointment's unique identifier.
example: appt_7c1d90

Request

curl -X GET https://api.vantaxai.com/v1/appointments/appt_7c1d90 \
  -H "Authorization: Bearer vx_live_3fa9c2..."

const res = await fetch(
  "https://api.vantaxai.com/v1/appointments/appt_7c1d90",
  {
  method: "GET",
  headers: {
    Authorization: "Bearer vx_live_3fa9c2...",
  },
  }
);
const { data } = await res.json();

import { Vantax } from "@vantax/sdk";

const vantax = new Vantax({ apiKey: process.env.VANTAX_API_KEY! });
// GET /v1/appointments/{appointment_id}
const result = await vantax.request("GET", "/v1/appointments/{appointment_id}");

from vantax import Vantax

vantax = Vantax(api_key=os.environ["VANTAX_API_KEY"])
# GET /v1/appointments/{appointment_id}
result = vantax.request("GET", "/v1/appointments/{appointment_id}")

Response

{
  "success": true,
  "data": {
    "id": "appt_7c1d90",
    "contact_id": "ct_4f8a21",
    "calendar_id": "cal_22f9",
    "agent_id": "agt_3d9b21",
    "title": "Dental cleaning consultation",
    "description": "New patient — requested morning slot",
    "appointment_date": "2026-06-09T15:00:00Z",
    "duration": 30,
    "status": "confirmed",
    "location": "Downtown Clinic, Suite 200",
    "created_at": "2026-06-08T09:12:00Z"
  }
}

{
  "success": false,
  "message": "Appointment not found"
}