API hosts

Accessing the Experience Cloud API hosts associated with your company's instance

Access to Medallia Experience Cloud is always made to a host associated to your company's instance. For example, consider this Medallia Web reporting URL:

https://express.medallia.eu/acme

That Medallia Web reporting URL matches this pattern:

https://{instance}{.domain}.{tld}/{company}

API hosts follow a these patterns:


Environment	Host pattern
Production	`{instance}-{company}.apis.medallia.com` The top-level domain is always ".com", regardless of the reporting instance's {tld}.
Sandbox	`{sandboxName}-{company}.apis.sbx.{dataCenter}.medallia.{tld}`
GovCloud production	`{instance}-{company}.apis.medalliafederal.com` Deprecated, but still supported: `company.apis.medalliafederal.com`
GovCloud sandbox	`{sandboxName}-{company}.apis.sbx.fedw1.medalliafederal.com`

Where:

instance name of the specific Medallia Experience Cloud service
domain is either "medallia" or "medalliafederal"
company identifies your company
tld is the top-level domain, such as ".com", ".eu", ".ca", ".com.au", etc.
sandboxName identifies a named sandbox instance
dataCenter is the abbreviation the data center hosting the sandbox. See Medallia Experience Cloud IP addresses and host names for the appropriate label for the data center.

Tip: In Medallia Setup you can see the URLs for you production and sandbox instances on the Public APIs Setup screen.

Some Medallia products, such as Conversations, have dedicated API gateways or other ways of accessing their content due to unique requirements or operating conditions. Check the product-specific API documentation for more details.

Example

For example, to access the production instance named "fo", of a company name of "acme", running in the London data center, use this endpoint:

fo-acme.apis.medallia.com/admin/v1/users/endpoint

To access the sandbox named staging for that same company:

staging-acme.apis.sbx.lon.medallia.eu/admin/v1/users/endpoint