Skip to main content

    Developer Reference

    Astramedica Public API Documentation

    Astramedica is a Virginia-based medical-travel coordination company connecting patients with vetted partner clinics in Turkey. We coordinate logistics and partner-clinic comparisons; independent physicians make all medical decisions. This documentation covers the read-only public endpoints exposed by the website for service discovery, health checks, and country-code lookup.

    Last updated: 2026-04-20OpenAPI JSONAPI Catalog

    Public API principles

    • All endpoints documented here are read-only and publicly accessible.
    • These endpoints support website functionality and discovery; they do not expose patient-specific records or protected clinical workflows.
    • For general coordination questions, contact info@astramedica.com or +1 202 500 5004.
    GET/api/health

    Health endpoint

    Use this endpoint to confirm the public Astramedica API surface is reachable. It exposes basic contact and catalog context only and does not include patient data or protected resources.

    Returns a lightweight public status payload for agents and developers.

    Short-lived public JSON response.

    Response fields

    • ok (boolean)

      True when the endpoint is healthy.

    • service (string)

      Human-readable API surface name.

    • version (string)

      Application version from package.json.

    • publicServices (number)

      Count of published service pathways.

    • contact (object)

      Public coordination contact details for follow-up questions.

    Example response

    {
  "ok": true,
  "service": "Astramedica Public API",
  "version": "1.0.0",
  "publicServices": 15,
  "contact": {
    "email": "info@astramedica.com",
    "phone": "+1 202 500 5004"
  }
}
    GET/api/services

    Services endpoint

    This endpoint provides a machine-readable summary of Astramedica's published coordination pathways. It falls back to the static site content if a database-backed service source is unavailable.

    Returns the published public service pathways.

    Public edge-cached JSON for one hour with stale-while-revalidate.

    Response fields

    • ok (boolean)

      True when the response is successful.

    • services (array)

      Published service summaries with a title and short description.

    Example response

    {
  "ok": true,
  "services": [
    {
      "title": "Stem Cell Excellence - Golden Vial",
      "description": "Coordinated access to a physician-supervised stem cell program in Turkey. Not FDA-approved. Astramedica coordinates; independent physicians administer."
    },
    {
      "title": "Hair Transplant",
      "description": "Coordinated access to FUE & DHI hair transplant programs in Turkey. Surgeons certified by the Turkish Board of Plastic Surgery. Astramedica coordinates, physicians perform."
    }
  ]
}
    GET/api/country-codes

    Country codes endpoint

    This endpoint supplies ISO2 country codes, country names, and telephone calling codes for Astramedica's public intake experiences.

    Returns country calling codes used by public enquiry forms.

    Public edge-cached JSON for one day with stale-while-revalidate.

    Response fields

    • ok (boolean)

      True when the response is successful.

    • countryCodes (array)

      Country-code lookup records used by public forms.

    Example response

    {
  "ok": true,
  "countryCodes": [
    {
      "iso2": "US",
      "countryName": "United States",
      "callingCode": "+1"
    }
  ]
}

    Machine-readable references