GET /countries

Lists all countries and its regions, indexed by its two-letter country codes. FIRST follows ISO 3166-1 standard for country code and name listings.

Repository Endpoint URL Credentials
FIRST API v1 Public

Additional Parameters

These parameters may also be added to the query string to filter the results:

Parameter Type Description
region string Region of the country.
q string Free text search at the country name, abbreviations and region.


These are the allowed scope for the FIRST Mailing Lists dataset:

Scope Description
public (default) Shows country name and region indexed by a two-letter abbreviation.
iso Shows country name and region indexed by a three-letter abbreviation (ISO and IOC default).
full Shows country name, region and abbreviations (2 and 3-letters).


The response object contains a list of valid lists:

curl -X GET ""
    "status": "OK",
    "status-code": 200,
    "version": "1",
    "total": 57,
    "limit": 3,
    "offset": 0,
    "access": "public",
    "data": {
        "DZ": {
            "country": "Algeria",
            "region": "Africa"
        "AO": {
            "country": "Angola",
            "region": "Africa"
        "BJ": {
            "country": "Benin",
            "region": "Africa"