API hosts

All API requests — regardless of the type of API or resource — are made to an API host associated with your company's instance. The URL of the host depends on these criteria:

  • Company name

  • Instance name

  • Domain type (such as .com, .eu, .ca, etc.)

  • Sandbox name (when accessing a sandbox instance)

  • Data center abbreviation (when accessing a sandbox). See Medallia IP addresses and hostnames for the appropriate label for the data center.

Tip: If you have access to Medallia Setup, you can see the URL for production or sandbox instances on the Public APIs Setup screen.

You can identify the instance and company names by looking at the URL you use to access Medallia Web reporting, which looks like this: https://instance.domain.type/company

EnvironmentHost pattern
Productionhttps://<instance>-<company>.apis.medallia.<type>
Sandbox https://<sandbox-name>-<company>.apis.sbx.<data-center>.medallia.<type>
GovCloud productionhttps://<instance>-<company>.apis.medalliafederal.<type>

Deprecated, but still supported — https://<company name>.apis.medalliafederal.com

GovCloud sandbox https://<sandbox-name>-<company-name>.apis.sbx.fedw1.medalliafederal.com
Important: Host URLs with the form https://<company>.apis.medallia.<type> are deprecated and only valid for legacy clients.

For example, to access the production instance named "fo", of a company name of "acme", running in the London data center, use this endpoint: https://fo-acme.apis.medallia.eu/admin/v1/resource-group/resource-group-version/endpoint

To access the sandbox named staging for that same company: https://staging-acme.apis.sbx.lon.medallia.eu/admin/v1/resource-group/resource-group-version/endpoint