Sign in
Aggregates

Aggregate search across every name field

Searches the q value across common, official, native, and alternates simultaneously.

get/countries/v5/name

Query parameters

qstring required

Search term. Case-insensitive substring match.

limitinteger

Number of records to return. Defaults to 25; accepts an integer from 1 to 100 on the free plan, or up to 500 on paid plans. Non-integer or below-range values return HTTP 400; a value above your plan's ceiling but within the paid maximum (e.g. 200 on a free plan) returns HTTP 403 indicating it is valid only on paid plans. See https://restcountries.com/docs#pagination for details.

offsetinteger

Number of records to skip for pagination. Default 0.

response_fieldsstring

Comma-separated dot-path projection. Only the specified fields are returned. Example: names.common,codes.alpha_2,flag.emoji

response_fields_omitstring

Comma-separated dot-path blocklist. The specified fields are removed from the response. Useful for trimming heavy branches like names.translations.

prettyboolean

Set to true (a bare ?pretty, 1, or true) to pretty-print the JSON response; 0 or false keep it minified. Default is minified.

Response

Paginated list of countries.

Changes

Changed in 1 of the 2 revisions of this API.25

  • 87a86bdd79f625See the full diff
    • ▲

      added Leader LeadersNotice to the data/objects/items/leaders/items/ response property oneOf list for the response status 200

      response-property-one-of-added

    • ▲

      the data/objects/items/leaders/items/ response's property type/format changed from object/ to / for status 200

      response-property-type-changed

    • ●

      removed the optional property data/objects/items/leaders/items/assets from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property data/objects/items/leaders/items/attributes from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property data/objects/items/leaders/items/links from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property data/objects/items/leaders/items/name from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property data/objects/items/leaders/items/title from the response with the 200 status

      response-optional-property-removed