# Getting started

<figure><img src="https://4254506030-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGX3vgmQkca7Meowb73cm%2Fuploads%2F1fWu1ovFb9mQVnOZVSxK%2FTimeline%20for%20knowledgebase%2002.jpg?alt=media&#x26;token=cede4f95-12c0-4478-b4b1-795dc6543e66" alt=""><figcaption></figcaption></figure>

### 1. Explore the Documentation

Review the [API Reference Docs](https://resources.abstractivehealth.com/api-documentation/reference-docs) to confirm our platform fits your use case for:

* Retrieving external medical records
* Summarizing clinical data with AI
* Querying medical records for clinical insights

### 2. Create an Account

Sign up via our [web application](https://app.abstractive.ai/sign-up?ref=api) to get started. This gives you access to our standalone dashboard and begins the setup process.

### 2b. Complete Clinician Verification (Required for Record Retrieval)

To retrieve medical records through the Carequality® Health Information Exchange (HIE), a licensed clinician must be verified.

We’ll ask for:

* Full name, email, mobile number
* Practice address
* NPI (National Provider Identifier)
* Valid photo ID

Account verification typically takes 48–72 hours. Once approved, you’ll be able to search for real patients and review AI summaries within the app. You'll be able to use the API while waiting for verification.

### 3. Try out the Application

Explore the application interface:

* Search for real patients (if verified)
* Upload your own PDFs
* Review AI-generated summaries
* Ask real questions on medical data with RAG

This gives you a hands-on preview of what you’ll receive via the API.

### 4. Download the data as JSON, CDA, or FHIR

From the app, you can export:

* AI summaries
* Original medical records

Choose between JSON, CDA, or FHIR formats as these are identical to the outputs you'll receive via the API.

### 5. Get an API Key from the App

Once logged in, go to the [**Account → API Access**](https://app.abstractive.ai/account?section=api-key) in the app to generate your personal API key.

### 6. Try the API using Swagger[^1] or GitHub

You can test the API right away in `test` mode:

* **Swagger UI**: Visit <https://docs.abstractivehealth.com/> to try endpoints directly with your API key.<br>
* **GitHub Notebook:** Clone our repo: <https://github.com/Abstractive-Health/abstractivehealth-public-scripts> . Follow the notebook to run queries using a demo patient.

### 7. Start Using It on Real Patients

Your free trial includes 30 days or 100 patient summaries, whichever comes first.

You can search, retrieve, and summarize real patient records, all through the app or API. When the trial ends, the subscription is based on our [API Pricing](https://www.abstractivehealth.com/startups#pricing).

{% hint style="info" %}
Please keep in mind that as per the Carequality® Framework Policy for reciprocity, you will need to send new treatment notes back to us via our API within 7 business days. [Learn more about Carequality® Framework Policy.](https://carequality.org/wp-content/uploads/2023/08/Carequality-Framework-Policies-v2.0-Final-20230627.pdf)
{% endhint %}

[^1]: Swagger allows you to describe the structure of your APIs so that machines can read them.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://resources.abstractivehealth.com/api-documentation/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.