Skip to content
  • Global Express Country

    Request

    The GlobalExpressCountry endpoint returns the country names containing the search term in the Country= parameter. Country names in five languages are returned:

    • English
    • Spanish
    • French
    • German
    • Simplified Chinese.
    Query
    idstring, (password)required

    Required. The License Key issued by Melissa.

    Example:id={REPLACE-WITH-YOUR-LICENSE-KEY}
    countrystringrequired

    Required. The search term for the country/countries desired.

    Default:"US"
    Example:country=US
    formatstring

    Desired format of the response. Possible values are json, jsonp, or xml, depending on the endpoint.

    Note: the base URL for JavaScript format request is https://expressentry.melissadata.net/jsonp/.

    Enum:"xml""json""jsonp"
    Example:format=json
    Headers
    Acceptstringrequired

    Format of the response.

    Enum:"application/json""application/javascript""*/*"
    Example:*/*
    Content-Typestringrequired

    Format of the request.

    Enum:"application/json""application/xml""application/javascript""*/*"
    Example:*/*
    curl -i -X GET \
      'https://expressentry.melissadata.net/web/GlobalExpressCountry?id=%7BREPLACE-WITH-YOUR-LICENSE-KEY%7D&country=US' \
      -H 'Accept: */*' \
      -H 'Content-Type: */*'

    Responses

    Global Express Country response

    Body
    Versionstring

    The current service version number.

    ResultCodestring

    Lists result codes for the most recent request. For more information, see Global Express Entry Result Codes.

    ErrorStringstring

    Lists error codes from any errors caused by the most recent request. For more information, see Global Express Entry Result Codes.

    ResultsArray of objects

    Array containing the record level fields.

    Response
    { "Version": "8.0.0.1249", "ResultCode": "XS01", "ErrorString": "", "Results": [ { … }, { … } ] }