MRR API-GPWebInquiry

MRR API-GPWebInquiry

Certain key data sets in the Market Readiness Repository (MRR) can be easily and quickly consumed via XML and JSON using the following static URLs, and then appending the right parameters. Each URL will return a full set of formatted data for the data list or object indicated.

The URL parameters are:

  • output: xml or json. The format of the returned data.
  • data: Object/Entity, e.g., CountryRegion, Language
  • id: Valid for Individual APIs only. The GUID of the individual entity record requested.
  • code: Valid for only certain individual APIs only—see below. The common code (e.g., BCP47 for language, ISO codes, etc.) for the entity being requested.
  • lang: Specific BCP47 code for return language, e.g., "fr-FR" or "ar-SA". Data returned will have the primary name of the Entity in the specified language. Not supported for all APIs. If there is no localized name for a data row, then the row is not returned. If no &lang= parameter is specified, the default is "en-US", which will always return all rows. Click here for a list of the supported BCP47 language codes you can use.

More of these APIs will be added in the future, providing simple and easy access to more data objects. Additionally, more attributes and data will be added to existing APIs. Note, however, that no existing parameters, tags, or metadata will be altered, so any changes will not break any code written against the current APIs.

If these MRR APIs do not meet your needs you can contact the Global Readiness team with any questions.


List APIs

Each List API URL returns a list of all individual entities of the specified data object. Each entity will have a standard set of attributes.

CountryRegion Table for reference, including GUIDs used in Individual APIs.

Data Object&lang= SupportXML URLJSON URL
Country/Region List Yes https://gpwebinquiry.microsoft.com/api/mrrentities?data=countryregion&lang=en-US&format=xml https://gpwebinquiry.microsoft.com/mrrentities?data=countryregion&lang=en-US&format=json
Language List Yes https://gpwebinquiry.microsoft.com/api/mrrentities?data=language&lang=en-US&format=xml https://gpwebinquiry.microsoft.com/mrrentities?data=language&lang=en-US&format=json
Language Fallback List Yes https://gpwebinquiry.microsoft.com/api/mrrentities?data=languagefallback&lang=en-US&format=xml https://gpwebinquiry.microsoft.com/mrrentities?data=languagefallback&lang=en-US&format=json

 


Individual APIs

Each Individual API URL below returns a detailed set of information about one entity. The &id= URL parameter specifices the entity to retrieve. The List APIs above can be used to get the GUID of the desired entity for which you want to see detailed individual data. Some APIs listed below will take a &code= URL parameter instead of a GUID.

Data Object&lang= SupportSample XML URLSample JSON URL
Country/Region (USA in these samples) No https://gpwebinquiry.microsoft.com/api/mrrentities?data=countryregion&id=95CF73BB-BB5D-E611-80DC-C4346BAC03FC&format=xml https://gpwebinquiry.microsoft.com/api/mrrentities?data=countryregion&id=95CF73BB-BB5D-E611-80DC-C4346BAC03FC&format=json
Language by GUID (English in these samples) No https://gpwebinquiry.microsoft.com/api/mrrentities?data=language&id=F1C3E017-2B5F-E611-80DD-FC15B4283D6C&format=xml https://gpwebinquiry.microsoft.com/api/mrrentities?data=language&id=F1C3E017-2B5F-E611-80DD-FC15B4283D6C&format=json