Skip to main content
GET
/
api
/
v1
/
appointment-requests
Get list of appointment requests
curl --request GET \
  --url https://{subdomain}.mihu.ai/api/v1/appointment-requests \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "message": "",
  "data": [
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "title": "Medical Consultation",
      "description": "Annual checkup",
      "start_time": "2025-11-25T10:00:00.000000Z",
      "end_time": "2025-11-25T10:30:00.000000Z",
      "status": "pending",
      "notes": "Patient prefers morning appointments",
      "schedule": {
        "id": 5,
        "name": "Dr. Smith - General Practice"
      },
      "contact": {
        "id": 123,
        "uuid": "660e8400-e29b-41d4-a716-446655440001",
        "name": "John",
        "surname": "Doe",
        "email": "john.doe@email.com",
        "phone_number": "+1-555-0100"
      },
      "created_at": "2025-11-23T08:00:00.000000Z"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developers.mindhunters.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Use a Bearer token to access these API endpoints. Example: "Bearer {your-token}"

Query Parameters

​
status
enum<string>

Filter by status (pending, approved, rejected)

Available options:
pending,
approved,
rejected
​
schedule_uuid
string<uuid>

Filter by schedule UUID

​
start_date
string<date>

Filter by start date (YYYY-MM-DD)

​
end_date
string<date>

Filter by end date (YYYY-MM-DD)

Response

Successful operation

​
success
boolean

Indicates whether the request completed successfully. True for successful responses; false for documented error responses.

Example:

true

​
message
string

Human-readable response message. Safe to display in logs or simple client notifications; use structured fields for program logic.

Example:

""

​
data
object[]