Base URIs

What Is the Base URI?

The Base URI (also known as the Instance URL) is the domain where the SAP Concur platform entity resides. You must specify which location you are trying to work with by making a change to the end point declaration before you make your API call.

There will be a different domain for each of the following locations:

  • Production in the North America data center, EMEA data center, China data center, and CCPS data center.
  • Implementation (copy of the production environment not available for all clients) in the North America data center and EMEA data center.

Production

Customer entities are hosted in various locations based on the client location, government regulations, and other special requirements. As a result, the correct Base URI must be used to reach a particular entity.

Data Center Environment Base URI Description
US2 Production https://us2.api.concursolutions.com Default for all API calls (Optionally request certs).
US2 Production https://www-us2.api.concursolutions.com Default for all API calls (Does not request certs).
EU2 Production https://eu2.api.concursolutions.com Default for all API calls (Optionally request certs).
EU2 Production https://www-eu2.api.concursolutions.com Default for all API calls (Does not request certs).
China Production https://cn.api.concurcdc.cn Default for all API calls (Optionally request certs).
China Production https://www-cn.api.concurcdc.cn Default for all API calls (Does not request certs).
CCPS Production https://usg.api.concursolutions.com Default for all API calls (Optionally request certs).
CCPS Production https://www-usg.api.concursolutions.com Default for all API calls (Does not request certs).

Implementation

The implementation base domains are used for implementation sites, also known as Production Sandbox Environments (PSE). A PSE is a copy of an SAP Concur platform entity made from a backup of a client’s production site. This feature is only available for the Professional edition of SAP Concur products. Prior to 2022, PSEs had been hosted on the implementation base domain which is separate from production though now PSEs are in the same environment as production.

Important: Please note that Base URI may differ based on whether PSE client was migrated from Implementation to production environment.

  • For migrated clients:
    • Because the API credential had been created in Implementation and not updated after migration, customers by default must use the below Implementation-specific links for API calls which will automatically be redirected to production. If migrated clients perform a direct API call using production URLs as listed above, it will fail with an error like “invalid client id.”
  • For net new clients:
    • Net new PSE clients can use the same URLs as their production entities for their API calls as listed in table above.
Data Center Environment Base URI Description
US Implementation https://us-impl.api.concursolutions.com Default for all API calls (Optionally request certs).
US Implementation https://www-us-impl.api.concursolutions.com Default for all API calls (Does not request certs).
EMEA Implementation https://emea-impl.api.concursolutions.com Default for all API calls (Optionally request certs).
EMEA Implementation https://www-emea-impl.api.concursolutions.com Default for all API calls (Does not request certs).

Pre-2017 Legacy URIs (Deprecated)

The following base URIs have been used for APIs that are authenticating using the legacy authentication method. The new base URIs have been adapted to become backwards compatible with the legacy authentication methods. As such, these legacy base URIs should not be used unless necessary. JWT calls are not compatible with the legacy base URIs.

To migrate to the current authentication method, review these resources:

  • https://developer.concur.com/api-reference/authentication/migrationguide.html
  • https://developer.concur.com/api-reference/authentication/oauth2-migration-best-practices.html

These URIs support the current authentication and the previous authentication simultaneously.

Data Center Environment Base URI Description
US Production https://www.concursolutions.com Legacy URI for API calls using pre-2017 authentication for production entities in North America.
EMEA Production https://eu1.concursolutions.com Legacy URI for API calls using pre-2017 authentication for production entities in Europe.
US Implementation https://implementation.concursolutions.com Legacy URI for API calls using pre-2017 authentication for implementation entities in North America.
EMEA Implementation https://eu1imp.concursolutions.com Legacy URI for API calls using pre-2017 authentication for implementation entities in Europe.

On this page