Endpoint Reference

Every data endpoint lives under /api/v1, requires a Bearer access token, and is gated by exactly one scope plus an active consent grant. List endpoints are paginated and return { data: [...], pagination: {...} }. Single-object endpoints return { data: {...} }.

Base URL: https://dperspective.galacticgeeks.com

Common conventions

Pagination

{
  "data": [ /* ... */ ],
  "pagination": { "page": 1, "pageSize": 20, "total": 137, "totalPages": 7 }
}

Errors

Every data endpoint may return UNSUPPORTED_VERSION, RATE_LIMITED, UNAUTHORIZED, TOKEN_EXPIRED, INSUFFICIENT_SCOPE, CONSENT_REQUIRED, ACCESS_NOT_RECORDED, or INTERNAL_ERROR. See Errors.

Health data

GET /api/v1/health-data

Lists health-data readings (vitals) for the authenticated user, newest first.

• Scope: read:health-data
• Query: page, pageSize

curl "https://dperspective.galacticgeeks.com/api/v1/health-data?pageSize=2" \
  -H "Authorization: Bearer <access_token>"

{
  "data": [
    { "id": "r_01", "type": "heart_rate", "value": 72, "unit": "bpm",
      "timestamp": "2025-01-01T10:00:00Z", "source": "wearable" },
    { "id": "r_02", "type": "spo2", "value": 98, "unit": "%",
      "timestamp": "2025-01-01T09:55:00Z", "source": "wearable" }
  ],
  "pagination": { "page": 1, "pageSize": 2, "total": 2, "totalPages": 1 }
}

GET /api/v1/aggregations

Returns a server-computed summary over the user’s health data (latest per type, averages, min/max, out-of-range counts). Derived; no raw records.

• Scope: read:aggregations

GET /api/v1/trends

Returns bucketized trend points (hourly/daily) over the user’s health data.

• Scope: read:trends
• Query: type (metric type), bucket (hour | day), plus pagination.

Symptoms

GET /api/v1/symptoms

Lists logged symptoms.

• Scope: read:symptoms
• Fields: id, description, severity, timestamp

Medications

GET /api/v1/medications

Lists the user’s medications.

• Scope: read:medications
• Fields: id, name, dosage, frequency, condition, pattern

GET /api/v1/medications/{id}/adherence

Returns the adherence history for one owned medication.

• Scope: read:medications
• Path: id — the medication id.

Conditions

GET /api/v1/conditions

• Scope: read:conditions
• Fields: id, name, severity, sinceDate

Allergies

GET /api/v1/allergies

• Scope: read:allergies
• Fields: id, name, severity, sinceDate

Appointments

GET /api/v1/appointments

• Scope: read:appointments
• Fields: id, title, dateTime, specialty, location

Weight

GET /api/v1/weight

• Scope: read:weight
• Fields: id, weightKg, date

Mood

GET /api/v1/mood

• Scope: read:mood
• Fields: id, mood, note, timestamp

Reports

GET /api/v1/reports

Lists generated health reports (summary representation only).

• Scope: read:reports
• Fields: id, generatedAt, dateRange, summary

Profile

GET /api/v1/profile

Returns the user’s demographics as a single object.

• Scope: read:profile
• Fields: name, gender, dateOfBirth, bloodType

EHR

GET /api/v1/ehr

Lists EHR-derived records imported from a connected provider.

• Scope: read:ehr
• Fields: id, resourceType, summary, timestamp

OAuth, developer & consent endpoints

These sit outside /api/v1. The /oauth/* endpoints authenticate with clientId/clientSecret; the /developer/* and /partner/consent/* endpoints authenticate with the end-user session.