UMPA: Getting Started

Getting Started with UMPA API

📘

Private beta

The embeddings API is currently in private beta. If. you would like access to the API, please email [email protected]

1. Obtaining an API Key

To use the UMPA API, you'll need an API key. Follow these steps to get your key:

  1. Click "Log In" to sign up for an account at https://genhealth.ai/
  2. Once logged in, navigate to the "API Keys" section in your account dashboard
  3. Click on "Generate New API Key"
  4. Copy your new API key and store it securely. You'll need this for all API requests

2. Making Your First API Request

Let's make a simple API request to get started. We'll use the /v1/cases endpoint to retrieve a list of cases.

Prerequisites

  • API key (obtained in step 1)
  • A tool for making HTTP requests (e.g., curl, Postman, or a programming language of your choice)

Example Request using curl

curl -X GET "https://api.umpa.genhealth.ai/v1/cases" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json"

Replace YOUR_API_KEY with the API key you obtained in step 1.

You can also find other examples of requests using our API Reference

Example Response

{
  "cases": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "patient_name": "John Doe",
      "status": "pending",
      "decision_recommendation": "approve",
      "case_submitted": "2023-04-15T14:30:00Z"
    },
    // ... more cases ...
  ],
  "pagination": {
    "currentPage": 1,
    "pageSize": 10,
    "totalPages": 5,
    "totalItems": 47
  }
}

3. Next Steps

Now that you've made your first API request, you can explore other endpoints and functionalities:

  • Upload PDF documents for a case
  • Extract patient data from documents
  • Perform adjudication based on medical policies
  • Look up relevant policies using medical codes

Refer to our full API documentation for detailed information on all available endpoints and features.

4. Need Help?

If you encounter any issues or have questions, please don't hesitate to contact our support team at [email protected].

Happy coding!