Work in progress. We welcome questions and suggestions — give us feedback.

Emmy Integration Guide

This guide is for decision makers trying to add eligibility tools to their state applicant process with Emmy. If you're a developer excited to implement Emmy for your state, check our full GitHub repository.

Integrating Eligibility Made Easy (Emmy) is a process guided by the needs of an individual state agency. Some questions to ask as you work with the Emmy team:

  • Which components of Emmy do I want to implement?
    • Income
    • Work Hours
    • Volunteer Hours
    • Education Hours/status
  • Do we want to use the Emmy interface, or build our own?

The Emmy experience for applicants is designed to be modular, letting you implement just the pieces you need. 
⚠️ Note that Emmy is currently in development, and modularity is a planned feature. Follow new updates in the GitHub repository.

Implementation using the Emmy interface

The complete Emmy application includes an interface for applicants to interactively offer their consent to load and submit employer, school, and volunteer data.

undefined

Future updates will include progress indicators that show how close the applicant has gotten to submitting complete data.

⚠️ Note that Emmy doesn't and won't approve applications independently, but progress indicators still yet applicants know if, for example, they've submitted work data for each of the last three months before submission.

When using Emmy with the user interface supplied by CMS, the process of an application will look something like this:

undefined
  1. An applicant visits a state application portal
  2. Applicants are directed to the Emmy UI, customized for that state's service
  3. The Emmy applicant interface takes applicant information and loads information from multiple outside data sources
  4. Applicants can see and approve the data being submitted
  5. The Emmy backend service delivers standardized data to the State Agency with the submitted data

If you have questions about how the Emmy interface can be customized for your state agency, and whether in general an Emmy-provided UI meets your state's and your applicants' needs, get in touch with the Emmy team via email.

Implementation using the Emmy API Service

If you want to implement your own interface, or if you have an existing application process where Emmy will be used only for additional verification, you may want to use Emmy as an API service. The process looks quite similar:

undefined

The only major change is that your own application portal will do the work of collecting Applicant interface, and offering the applicant feedback about the data they're submitting.

How to get started

Start integrating Emmy today by checking out our implementation checklist and reaching out to the Emmy team via email.

Looking for U.S. government information and services?
Visit USA.gov