Once your generic sandbox has been provisioned, you will receive an email with the credentials and details needed to begin development. These credentials include a Username, Password, and Key. Using these, you can generate Access and Refresh tokens via the OAuth2 "Password Grant" endpoint (see the "Authentication" section).

Environment Keys

The specific key you use depends on the environment:

Staging/Development: https://stage.ema-api.com/ema-dev/firm/
Training: https://stage.ema-api.com/ema-training/firm/
Production: https://mmapi.ema-api.com/ema-prod/

You will not receive a production key until you have completed the required steps outlined below. Include the key in the header for all API calls: x-api-key={key}.

By default, your sandbox environment provides access to all resources so you can explore the full capabilities of the API.

Requesting Resources

Once development is nearing completion, you'll need to inform ModMed which specific resources your application requires to go live. Please note that resource provisioning can take up to two weeks after submission, so it’s important to submit your request in advance to avoid delays.

To register your application with ModMed, submit the following details to your MMI contact:

Vendor Name
Application Name
Application Description
Desired Resources: Specify the API resources your application requires (e.g., Patient READ/SEARCH, ChargeItem CREATE/READ/SEARCH, Practitioner READ/SEARCH, etc.).

Final Review Process
When your application is ready, we will schedule a demo and technical review. The review typically includes:

An end-to-end demo of your system.
A Proof of Concept demonstration, showing full functionality within your sandbox.
A technical discussion to review the API resources in use and how often they will be called.

Once the demo and technical discussion are successfully completed and your desired resources are provisioned, you will receive a production key and instructions on how to take practices live with your application.