## Fountain API base URL

When using the preferred OAuth flow, 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.

### URL

```text
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:

### URL

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

For example, to retrieve applicants, you would use:

### URL

```text
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:

```undefined
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.