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.