API Reference
Log In
API Reference

Tenant API URLs

Fountain API base URL

When using the preferred OAuth flow highlighted here, all Hire APIs are available through the base URL https://services.fountain.com/api/servicehire, regardless of region or tenant. In the background, our authentication layer will automatically find the correct tenant and redirect requests to the correct one.

https://services.fountain.com/api/servicehire/v2/

Hire tenants

Fountain Hire also offers dedicated endpoints when using one of the legacy authentication flows (using the X-ACCESS-TOKEN method). Fountain operates across multiple regions to serve customers around the world. Depending on your region, you’ll be able to use a different API URL. This article explains how to determine the correct URL for your account.

There are two main types of API URLs:

Main tenant URL

If when you login to your account, you see http://app.fountain.com/ or http://web.fountain.com/, the URL that you will use to use the API is:

http://api.fountain.com/v2/

For example, to retrieve applicants, you would use:

https://api.fountain.com/v2/applicants

Region-specific URL

If when you login to your account, you see http://us-2.fountain.com or http://app.us-2.fountain.com or any other region name instead of "us-2" in the URL, you will use:

http://us-2.fountain.com/api/v2

Be mindful that you will have to replace us-2 with the name of the region your account is hosted on.