{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Getting Started with Axiomera API","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"__idx":0,"id":"getting-started-with-axiomera-api"},"children":["Getting Started with Axiomera API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Welcome to Axiomera API documentation. This guide will help you get started with using our APIs."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"__idx":1,"id":"overview"},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Axiomera provides three main APIs:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Axiomera Core API"]},": Main application API for managing dental practices, appointments, and services"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["FHIR R4 API"]},": Healthcare data API following the FHIR R4 standard"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication API"]},": Handles user management and authentication"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All APIs use JWT (JSON Web Token) authentication and are available in both staging and production environments."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"__idx":2,"id":"base-urls"},"children":["Base URLs"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Staging: https://api-staging.heydonto.com\nProduction: https://api.heydonto.com\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We recommend testing your integration in the staging environment before moving to production."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"__idx":3,"id":"authentication"},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All APIs require authentication using JWT bearer tokens. Follow these steps to authenticate:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"__idx":4,"id":"1-generate-an-authentication-token"},"children":["1. Generate an Authentication Token"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Make a POST request to the login endpoint:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /auth/login\nContent-Type: application/json\n\n{\n    \"email\": \"your-email@example.com\",\n    \"password\": \"your-password\"\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Successful response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"accessToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"__idx":5,"id":"2-use-the-token"},"children":["2. Use the Token"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Include the token in the Authorization header for all subsequent requests:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /api/endpoint\nAuthorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"__idx":6,"id":"3-token-management"},"children":["3. Token Management"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Tokens are valid for 24 hours"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Store tokens securely"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not share tokens across applications"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Regenerate tokens when expired"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"__idx":7,"id":"api-structure"},"children":["API Structure"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"__idx":8,"id":"axiomera-core-api"},"children":["Axiomera Core API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Manages dental practice operations:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Appointment Types"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Brands"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Dental Practices"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Dental Services"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Organizations"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Practice Management Systems"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sites"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Assistants"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Periomeasure"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example request:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /dental-practices\nAuthorization: Bearer your-token-here\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"__idx":9,"id":"fhir-resources"},"children":["FHIR Resources"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Axiomera FHIR API implements the following FHIR R4 resources. Each resource is available at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/fhir/{resource-name}"]}," with full CRUD operations and history tracking."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":10,"id":"administrative-resources"},"children":["Administrative Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Account"]},": Financial accounts, balance, and charges"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Organization"]},": Healthcare providers, insurers, and departments"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Patient"]},": Demographics and other patient administrative information"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Practitioner"]},": Healthcare providers' demographic and administrative information"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PractitionerRole"]},": Roles and specialties of practitioners at organizations"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Location"]},": Physical locations where services are provided"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HealthcareService"]},": Services provided at a location/organization"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":11,"id":"clinical-resources"},"children":["Clinical Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["AllergyIntolerance"]},": Allergies and intolerances"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Condition"]},": Problems, diagnoses, and health concerns"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Procedure"]},": Actions taken for patient"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Observation"]},": Measurements and simple assertions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["DiagnosticReport"]},": Diagnostic test reports and results"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["CarePlan"]},": Healthcare plans and sets of actions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["CareTeam"]},": Group of practitioners caring for a patient"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Goal"]},": Desired outcomes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NutritionOrder"]},": Diet and nutritional requirements"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":12,"id":"scheduling-resources"},"children":["Scheduling Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Appointment"]},": Healthcare appointments"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["AppointmentResponse"]},": Responses to appointment requests"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Schedule"]},": Available time slots"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Slot"]},": Time slots where appointments can be booked"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":13,"id":"medications"},"children":["Medications"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Medication"]},": Details about medications"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MedicationRequest"]},": Prescriptions and medication orders"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MedicationDispense"]},": Dispensing of medications"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MedicationAdministration"]},": Administration of medications"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MedicationStatement"]},": Record of medication usage"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MedicationKnowledge"]},": Drug information and knowledge"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":14,"id":"diagnostics--investigations"},"children":["Diagnostics & Investigations"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ImagingStudy"]},": Medical imaging studies"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Media"]},": Images, videos, and audio"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Specimen"]},": Physical samples"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["BodyStructure"]},": Body sites and structures"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":15,"id":"documents--lists"},"children":["Documents & Lists"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["DocumentReference"]},": References to documents"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["DocumentManifest"]},": Sets of documents"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["List"]},": General-purpose list of resources"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Composition"]},": Composition of healthcare documents"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":16,"id":"care-provision"},"children":["Care Provision"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ServiceRequest"]},": Orders and requests for services"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Task"]},": Work items or actions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Communication"]},": Record of communication events"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["CommunicationRequest"]},": Requests for communication"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["DeviceRequest"]},": Orders for medical devices"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"__idx":17,"id":"financial-resources"},"children":["Financial Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Claim"]},": Healthcare financial claim"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ClaimResponse"]},": Adjudication response to claims"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Coverage"]},": Insurance or payment coverage"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ExplanationOfBenefit"]},": Explanation of benefits"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PaymentNotice"]},": Payment notifications"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Invoice"]},": Billable services"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":18,"id":"clinical-research"},"children":["Clinical Research"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ResearchStudy"]},": Research studies"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ResearchSubject"]},": Subject participation in research"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Evidence"]},": Evidence for clinical recommendations"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["RiskAssessment"]},": Potential outcomes assessment"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":19,"id":"medications--substances"},"children":["Medications & Substances"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Substance"]},": Physical materials"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SubstanceSpecification"]},": Detailed substance definitions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MedicinalProduct"]},": Regulated medication products"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MedicinalProductIngredient"]},": Ingredients in medicinal products"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":20,"id":"public-health--quality"},"children":["Public Health & Quality"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Measure"]},": Quality measures and metrics"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MeasureReport"]},": Results of quality measures"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ImmunizationRecommendation"]},": Vaccine recommendations"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Immunization"]},": Vaccine administration records"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":21,"id":"security--privacy"},"children":["Security & Privacy"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["AuditEvent"]},": Security audit logs"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Consent"]},": Privacy consents"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Provenance"]},": Resource origin and changes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["VerificationResult"]},": Verification results"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":22,"id":"foundation-resources"},"children":["Foundation Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Binary"]},": Raw data content"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bundle"]},": Collection of resources"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parameters"]},": Operation parameters"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OperationOutcome"]},": Operation results/errors"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":23,"id":"conformance-resources"},"children":["Conformance Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["CapabilityStatement"]},": API capabilities"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["StructureDefinition"]},": Resource structure definitions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ValueSet"]},": Value set definitions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["CodeSystem"]},": Code system definitions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SearchParameter"]},": Search parameter definitions"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":24,"id":"additional-resources"},"children":["Additional Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["DetectedIssue"]},": Clinical issues"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Device"]},": Medical devices"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["DeviceDefinition"]},": Device definitions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["DeviceMetric"]},": Device measurements"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["DeviceUseStatement"]},": Record of device usage"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["EndPoint"]},": Network service endpoints"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Flag"]},": Clinical flags"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Group"]},": Groups of resources"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Person"]},": Person demographics"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["RelatedPerson"]},": People involved in care"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Questionnaire"]},": Structured data collection"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["QuestionnaireResponse"]},": Answers to questionnaires"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each resource supports the following operations:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["GET /{resource}: Search/read resources"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["POST /{resource}: Create new resource"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["GET /{resource}/{id}: Read specific resource"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["PUT /{resource}/{id}: Update specific resource"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["DELETE /{resource}/{id}: Delete specific resource"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["GET /{resource}/{id}/history: Get resource version history"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For detailed information about each resource's structure and usage, refer to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"http://hl7.org/fhir/R4/"},"children":["FHIR R4 specification"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"__idx":25,"id":"example-code"},"children":["Example Code"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["JavaScript/Node.js example using fetch:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"async function getAuthToken(email, password) {\n  const response = await fetch(\"https://api-staging.heydonto.com/auth/login\", {\n    method: \"POST\",\n    headers: {\n      \"Content-Type\": \"application/json\",\n    },\n    body: JSON.stringify({ email, password }),\n  });\n\n  return await response.json();\n}\n\nasync function makeApiRequest(token, endpoint) {\n  const response = await fetch(`https://api-staging.heydonto.com${endpoint}`, {\n    headers: {\n      Authorization: `Bearer ${token}`,\n      \"Content-Type\": \"application/json\",\n    },\n  });\n\n  return await response.json();\n}\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Python example using requests:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","header":{"controls":{"copy":{}}},"source":"import requests\n\ndef get_auth_token(email, password):\n    response = requests.post(\n        'https://api-staging.heydonto.com/auth/login',\n        json={'email': email, 'password': password}\n    )\n    return response.json()\n\ndef make_api_request(token, endpoint):\n    headers = {\n        'Authorization': f'Bearer {token}',\n        'Content-Type': 'application/json'\n    }\n    response = requests.get(\n        f'https://api-staging.heydonto.com{endpoint}',\n        headers=headers\n    )\n    return response.json()\n","lang":"python"},"children":[]}]},"headings":[{"value":"Getting Started with Axiomera API","id":"getting-started-with-axiomera-api","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Base URLs","id":"base-urls","depth":2},{"value":"Authentication","id":"authentication","depth":2},{"value":"1. Generate an Authentication Token","id":"1-generate-an-authentication-token","depth":3},{"value":"2. Use the Token","id":"2-use-the-token","depth":3},{"value":"3. Token Management","id":"3-token-management","depth":3},{"value":"API Structure","id":"api-structure","depth":2},{"value":"Axiomera Core API","id":"axiomera-core-api","depth":3},{"value":"FHIR Resources","id":"fhir-resources","depth":3},{"value":"Administrative Resources","id":"administrative-resources","depth":4},{"value":"Clinical Resources","id":"clinical-resources","depth":4},{"value":"Scheduling Resources","id":"scheduling-resources","depth":4},{"value":"Medications","id":"medications","depth":4},{"value":"Diagnostics & Investigations","id":"diagnostics--investigations","depth":4},{"value":"Documents & Lists","id":"documents--lists","depth":4},{"value":"Care Provision","id":"care-provision","depth":4},{"value":"Financial Resources","id":"financial-resources","depth":2},{"value":"Clinical Research","id":"clinical-research","depth":4},{"value":"Medications & Substances","id":"medications--substances","depth":4},{"value":"Public Health & Quality","id":"public-health--quality","depth":4},{"value":"Security & Privacy","id":"security--privacy","depth":4},{"value":"Foundation Resources","id":"foundation-resources","depth":4},{"value":"Conformance Resources","id":"conformance-resources","depth":4},{"value":"Additional Resources","id":"additional-resources","depth":4},{"value":"Example Code","id":"example-code","depth":3}],"frontmatter":{"seo":{"title":"Getting Started with Axiomera API"}},"lastModified":"2026-08-09T16:14:32.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/get-started","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}