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 (scope-wise)

Health data is not a single endpoint. Each metric category has its own endpoint and its own scope, so an app reads only the categories the user consented to. All category endpoints are paginated and return the same field set: id, type, value, unit, timestamp, source.

GET /api/v1/health-data/{category}

Lists the user’s readings for one metric category, newest first.

• Query: page, pageSize

curl "https://dperspective.galacticgeeks.com/api/v1/health-data/heart?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": "dperspective_watch" },
    { "id": "r_02", "type": "Resting HR", "value": 58, "unit": "bpm",
      "timestamp": "2025-01-01T07:00:00Z", "source": "apple_watch" }
  ],
  "pagination": { "page": 1, "pageSize": 2, "total": 2, "totalPages": 1, "hasNext": false }
}

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.