Skip to main content
U.S. flag

An official website of the United States government

Dot gov

Official websites use .gov
A .gov website belongs to an official government organization in the United States.


Secure .gov websites use HTTPS
A lock ( Https ) or https:// means you've safely connected to the .gov website. Share sensitive information only on official, secure websites.

Frequently asked questions

We encourage you to create an account directly on or an agency partner like USAJobs to see in action. Generally a site will place a login button on their site. When the user clicks this button they redirect to where they can sign in or create an account. The site will be branded with the agency logo and can include help text for migrating existing users. After authenticating with they are redirected back to the agency with a unique UUID or email address that identifies the user.

We offer email address and UUID. Since a user can change their email address we recommend tracking users by UUID.

Yes. This is why we recommend using UUID as the primary key.

Every user has a unique UUID per agency for privacy reasons. This means that the same user can return a different UUID depending on which agency they are signing in to. These UUIDs are also globally unique. We do offer sharing of UUIDs between agencies with user consent on a case by case basis.

Once a user is authenticated on and passed back to the agency it is up to the agency to manage the user’s session. We do not remotely invalidate or expire a user’s session. makes no guarantees on IP addresses or ranges. Please use the DNS when querying for the latest IPs.

Check the error that was returned. Generally we return the specific errors in the HTML, JSON, or in the redirect url.

Feel free to contact the engineers at They can help diagnose your problem further.


No. only works via redirects to and from an agency site.

No. only handles authentication. Granting users specific access and permissions is handled on the agency side. For example, some agencies use active directory to store what applications a user can access. has a public status page available at where you can subscribe to incident notifications via email, SMS, Slack, or RSS.