Retrieving information with the API

This topic guide explains how to retrieve information from the Cool Farm Tool.

All URLs start with /api/v1/.

GET /farm/

Retrieve all data entered on the “Farm settings” page, and a summary list of all crop and livestock products

Example request

GET /farm/ HTTP/1.1
Host: app.coolfarmtool.org
Accept: application/json
X-API-Authorization: ...
X-APP-Authorization: ...

Example response

HTTP/1.1 200 OK
Content-Type: application/json

{
    "_uri": "/api/v0/farm/",
    "name": "Magdalen Farms",
    "country": {
        "_uri": "/api/v0/country/826/",
        "iso2": "GB",
        "id": "826",
        "name": "United Kingdom"
    },
    "territory": null,
    "average_temperature_value": 17.0,
    "average_temperature_unit": "°C",
    "products": [
        {
            "_uri": "/api/v0/product/396357AE/",
            "slug": "396357AE",
            "name": "chickens_2014"
        },
        {
            "_uri": "/api/v0/product/A47B1D80/",
            "slug": "A47B1D80",
            "name": "dry_bean_2013"
        }, {
            "_uri": "/api/v0/product/25D376B4/",
            "slug": "25D376B4",
            "name": "rice_2013"
        }
    ]
}
Request Headers
GET /farm_assessment/(str: slug)/

Retrieve results for the crop or livestock assessment specified by slug

Example request

GET /farm_assessment/.../ HTTP/1.1
Host: app.coolfarmtool.org
Accept: application/json
X-API-Authorization: ...
X-APP-Authorization: ...

Example response

HTTP/1.1 200 OK
Content-Type: application/json

[
  {
    "reporting_year": 2020,
    "name": "brown-swiss_2020",
    "has_co_products": false,
    "date_time": {
      "name": "start",
      "id": 1
    },
    "date_month": 1,
    "product_dry": {
      "value": "39.00000000",
      "unit": "kg"
    },
    "protein": {
      "protein_measure": {
        "unit": "True protein content",
        "id": "True protein content"
      }
    },
    "herd_sections": [
      {
        "calf_dairy": {
          "total_animals": 10,
          "fertilisers": [],
          "herd": {
            "live_weight": {
              "unit": "kg",
              "value": "152.00000000"
            },
            "sold_animals": {
              "total_sold": 10,
              "total_sold_weight": {
                "value": "152.00000000",
                "unit": "kg"
              }
            },
            "purchased_animals": {
              "total_purchased": 10,
              "total_purchased_weight": {
                "value": "152.00000000",
                "unit": "kg"
              }
            }
          }
        },
        "grazing": {
          "days": "null",
          "hours": 2,
          "category": "Confined pasture",
          "quality": "null",
          "fertilisation_approach": "Grazing, grass silage and hay area combined",
          "grazing_area": {
            "unit": "ha",
            "value": "10.00000000"
          }
        },
        "feed_approach": [
          {
            "name": "Grass fresh managed - on farm",
            "quantity": {
              "unit": "kg",
              "value": "0.03000000"
            }
          }
        ]
      }
    ],
    "ghg_results": {
      "direct_energy": [
        0,
        0,
        0,
        0,
        "0E+26"
      ],
      "transport": [
        0,
        0,
        0,
        0,
        "0E+26"
      ],
      "grazing": [
        0,
        "0",
        0,
        "0.00000",
        "0E+21"
      ],
      "feed": [
        "0.919800000000000000",
        0,
        0,
        "0.919800000000000000",
        "0.02297754855187485048182819818"
      ],
      "manure": [
        0,
        "0E-30",
        "0.0008082357073170731707317073169",
        "0.02020589268292682926829268293",
        "0.0005047639488540160939792458443"
      ],
      "enteric": [
        0,
        0,
        "2.272641509433962264150943396",
        "56.81603773584905660377358490",
        "1.419322967602332408468722933"
      ],
      "fertiliser": [
        "0",
        "0.00000",
        0,
        "0.00000",
        "0E+21"
      ]
    }
  }
]
Request Headers
Status Codes
GET /product/(str: slug)/

Retrieve results for the crop or livestock product specified by slug

Example request

GET /product/.../ HTTP/1.1
Host: app.coolfarmtool.org
Accept: application/json
X-API-Authorization: ...
X-APP-Authorization: ...

Example response

HTTP/1.1 200 OK
Content-Type: application/json

{
    "general": [
        {
            "name": "Crop type",
            "value": "Rice"
        },
        {
            "name": "Reporting year",
            "value": 2013
        },
        {
            "unit": "tonne",
            "name": "Fresh product",
            "value": "50.00000000"
        },
        {
            "unit": "tonne",
            "name": "Finished product",
            "value": "50.00000000"
        },
        {
            "unit": "kg / ha",
            "name": "Product yield",
            "value": "5000"
        },
        {
            "name": "Growing area",
            "value": "10.00 hectares, medium, moist"
        },
        {
            "unit": "hectare",
            "name": "Size",
            "value": "10.00000000"
        },
        {
            "name": "Name",
            "value": "rice_2013"
        }
    ],
    "machinery": {
        "bar_graph": [
            {
                "name": "disc gang",
                "value": "257.994738580000000000000000"
            }
        ]
    },
    "direct_energy": {
        "diesel": "1000.00000000"
    },
    "fertilisers": [
        {
            "reference": "Represents 2007 technology globally. Based on: International Fertilizer Industry Association (IFA, 2009). Fertilizers, Climate Change and Enhancing Agricultural Productivity Sustainably. IFA, Paris.",
            "is_custom": false,
            "CO2": "212.53",
            "name": "Compound NPK - 15% N / 15% K2O / 15% P2O5",
            "total_CO2e": "212.53"
        },
        {
            "reference": "Emissions from production are attributed to another\n                        production or waste system ",
            "is_custom": false,
            "CO2": "0.00",
            "name": "Pig manure - 0.7% N",
            "total_CO2e": "0.00"
        }
    ],
    "transport": {
        "bar_graph": [
            {
                "name": "road (HGV)",
                "value": "176.9137818419333768778576094"
            }
        ]
    },
    "co_product": {
        "table": [],
        "bar_graph": []
    },
    "total_emissions": {
        "total": [
            {
                "per_product": "1100.95",
                "per_tree": "nan",
                "CO2": "3942.43",
                "N2O": "7.99",
                "name": "Total",
                "total_CO2e": "55047.53",
                "per_area": "5504.75",
                "CH4": "1948.95"
            }
        ],
        "table": ["..."],
        "bar_graph": ["..."]
    },
    "summary": {
        "emissions_product": [
            "1100.950602056338736161477241",
            "kg CO2e"
        ],
        "emissions_total": [
            "55047.53010281693680807386203",
            "kg CO2e"
        ],
        "emissions_area": [
            "5504.753010281693680807386203",
            "kg CO2e"
        ]
    },
    "type": "crop",
    "field_management": {
        "table": ["..."],
        "pie_graph": {"..."},
        "max_percentage": [
            {
                "name": "paddy",
                "value": "93.82087027823590679133421277"
            }
        ]
    }
}
Request Headers
Status Codes
GET /energy/

Retrieve a list of all energy sources, with the units that are valid for each

The Direct energy type table is also available in this documentation.

Example request

GET /energy/ HTTP/1.1
Host: app.coolfarmtool.org
Accept: application/json
X-APP-Authorization: ...

Example response

HTTP/1.1 200 OK
Content-Type: application/json

[
  {
    "valid_units": [
      [
        15,
        "litre"
      ],
      [
        26,
        "gal"
      ],
      [
        32,
        "m3"
      ],
      [
        40,
        "gal (US)"
      ],
      [
        57,
        "ha-mm"
      ],
      [
        58,
        "ha-cm"
      ],
      [
        59,
        "acre-in"
      ]
    ],
    "_uri": "/api/v0/energy/102/",
    "id": "102",
    "name": "diesel"
  },
  "..."
]
Request Headers
GET /fertiliser/

Retrieve a list of all fertiliser products

The Fertiliser type table is also available in this documentation.

Example request

GET /fertiliser/ HTTP/1.1
Host: app.coolfarmtool.org
Accept: application/json
X-APP-Authorization: ...

Example response

HTTP/1.1 200 OK
Content-Type: application/json

[
  {
    "ingredients": [
      "n"
    ],
    "_uri": "/api/v0/fertiliser/1/",
    "id": "1",
    "name": "Ammonium bicarbonate - 18% N"
  },
  "..."
  {
    "ingredients": [
      "so3",
      "n"
    ],
    "_uri": "/api/v0/fertiliser/3/",
    "id": "3",
    "name": "Ammonium sulphate - 21% N"
  },
  "..."
]
Request Headers
GET /unit/

Retrieve a list of all units.

The Unit table is also available in this documentation.

Example request

GET /unit/ HTTP/1.1
Host: app.coolfarmtool.org
Accept: application/json
X-APP-Authorization: ...

Example response

HTTP/1.1 200 OK
Content-Type: application/json

[
  {
    "conversions": [
      {
        "factor": "100.00000000",
        "id": 3,
        "intercept": "0.00000",
        "name": "cm"
      },
      {
        "factor": "39.37000000",
        "id": 49,
        "intercept": "0.00000",
        "name": "in"
      },
      {
        "factor": "3.28100000",
        "id": 50,
        "intercept": "0.00000",
        "name": "ft"
      },
      {
        "factor": "1000.00000000",
        "id": 60,
        "intercept": "0.00000",
        "name": "mm"
      }
    ],
    "_verbose_name": "metre",
    "id": "1",
    "name": "m"
  }
]
Request Headers
GET /crop_type/

Retrieve a list of all crop types.

The Crop type table is also available in this documentation.

Example request

GET /crop_type/ HTTP/1.1
Host: app.coolfarmtool.org
Accept: application/json
X-APP-Authorization: ...

Example response

HTTP/1.1 200 OK
Content-Type: application/json

[{"id": "1", "name": "Alfalfa"},]
Request Headers
POST /user/key/

Fetch the API key for the given user.

Form Parameters
  • str username

  • int password

Example request

POST /user/key/ HTTP/1.1
Host: app.coolfarmtool.org
Accept: application/json
Content-Type: application/json
X-APP-Authorization: ...

username=test&password=password

Example response

HTTP/1.1 200 OK
Content-Type: application/json

{"key": "j1SSgBO4CIu4hjceBF0tVHVUqYUfibUxOEN18FQkVdE"}
Request Headers
Status Codes
GET /share_code/

Retrieve a list of all share codes.

Example request

GET /share_code/ HTTP/1.1
Host: app.coolfarmtool.org
Accept: application/json
X-API-Authorization: ...
X-APP-Authorization: ...

Example response

HTTP/1.1 200 OK
Content-Type: application/json

[
  {
    "id": 351,
    "name": "Test",
    "code": "TEST"
  },
  {
    "id": 352,
    "name": "Varun New",
    "code": "1103"
  }
]
Request Headers
GET /share_code/assessments/(str: share_code)/

Retrieve results for the crop or livestock product specified by share_code

Example request

GET /share_code/assessments/.../ HTTP/1.1
Host: app.coolfarmtool.org
Accept: application/json
X-API-Authorization: ...
X-APP-Authorization: ...

Example response

HTTP/1.1 200 OK
Content-Type: application/json

[
    {
        "share_farm": true,
        "code": "share_code_name",
        "products": [
            {
                "owner": "username",
                "data": {
                    "crop_type": "Soyabean",
                    "product_fresh": {
                        "value": "10000.00000000",
                        "unit": "tonne"
                    },
                    "field_size": {
                        "unit": "ha",
                        "value": "1000.00000000"
                    },
                    "ghg_results": {
                        "emissions_total": [
                            "973426.0824827620628357489093",
                            "kg CO2e"
                        ],
                        "product_yield": [
                            "10",
                            "tonne / ha"
                        ],
                        "pie_graph": {...}
                            ]
                        },
                        "emissions_product": [
                            "97.34260824827620628357489093",
                            "kg CO2e"
                        ],
                        "emissions_area": [
                            "973.4260824827620628357489093",
                            "kg CO2e"
                        ],
                        "pie_graph_unit": [...],
                        "pie_graph_area": [...]
                    },
                    "name": "soyabean_2019",
                    "fertiliser_applications": [...],
                    "direct_energy": [...],
                    "irrigation": {...},
        ],
        "id": "...",
        "name": "test_agg_group"
    }
]
Request Headers
Status Codes
GET /reference/country/

Retrieve a list of all countries.

Example request

GET /reference/country/ HTTP/1.1
Host: app.coolfarmtool.org
Accept: application/json
X-API-Authorization: ...
X-APP-Authorization: ...

Example response

HTTP/1.1 200 OK
Content-Type: application/json

[
  {
    "id": 16,
    "iso3": "AND",
    "name": "Andorra",
    "continent": "Western Europe"
  },
  {
    "id": 784,
    "iso3": "ARE",
    "name": "United Arab Emirates",
    "continent": "Middle East"
  },
  {
    "id": 2,
    "iso3": "ATG",
    "name": "Antigua and Barbuda",
    "continent": "Latin America"
  },
  {
    "id": 660,
    "iso3": "AIA",
    "name": "Anguilla",
    "continent": "Latin America"
  },
  {
    "id": 895,
    "iso3": "ALB",
    "name": "Albania",
    "continent": "Eastern Europe"
  },
  {
    "id": 41,
    "iso3": "ARM",
    "name": "Armenia",
    "continent": "Asia"
  },
  {
    "id": 20,
    "iso3": "AGO",
    "name": "Angola",
    "continent": "Africa"
  },
  {
    "id": 26,
    "iso3": "ARG",
    "name": "Argentina",
    "continent": "Latin America"
  },
  {
    "id": 14,
    "iso3": "ASM",
    "name": "American Samoa",
    "continent": "Oceania"
  },
  {
    "id": 32,
    "iso3": "AUT",
    "name": "Austria",
    "continent": "Western Europe"
  },
  {
    "id": 30,
    "iso3": "AUS",
    "name": "Australia",
    "continent": "Oceania"
  },
  {
    "id": 533,
    "iso3": "ABW",
    "name": "Aruba",
    "continent": "Latin America"
  },
  {
    "id": 248,
    "iso3": "ALA",
    "name": "Åland",
    "continent": "Western Europe"
  },
  {
    "id": 25,
    "iso3": "AZE",
    "name": "Azerbaijan",
    "continent": "Asia"
  },
  {
    "id": 56,
    "iso3": "BIH",
    "name": "Bosnia and Herzegovina",
    "continent": "Eastern Europe"
  },
  {
    "id": 42,
    "iso3": "BRB",
    "name": "Barbados",
    "continent": "Latin America"
  },
  {
    "id": 40,
    "iso3": "BGD",
    "name": "Bangladesh",
    "continent": "Indian Subcontinent"
  },
  {
    "id": 46,
    "iso3": "BEL",
    "name": "Belgium",
    "continent": "Western Europe"
  },
  {
    "id": 854,
    "iso3": "BFA",
    "name": "Burkina Faso",
    "continent": "Africa"
  },
  {
    "id": 100,
    "iso3": "BGR",
    "name": "Bulgaria",
    "continent": "Eastern Europe"
  },
  {
    "id": 4,
    "iso3": "BHR",
    "name": "Bahrain",
    "continent": "Middle East"
  },
  {
    "id": 108,
    "iso3": "BDI",
    "name": "Burundi",
    "continent": "Africa"
  },
  {
    "id": 204,
    "iso3": "BEN",
    "name": "Benin",
    "continent": "Africa"
  },
  {
    "id": 652,
    "iso3": "BLM",
    "name": "Saint Barthélemy",
    "continent": "Latin America"
  },
  {
    "id": 48,
    "iso3": "BMU",
    "name": "Bermuda",
    "continent": "North America"
  },
  {
    "id": 896,
    "iso3": "BRN",
    "name": "Brunei Darussalam",
    "continent": "Asia"
  },
  {
    "id": 6,
    "iso3": "BOL",
    "name": "Bolivia",
    "continent": "Latin America"
  },
  {
    "id": 535,
    "iso3": "BES",
    "name": "Bonaire, Sint Eustatiusand Saba",
    "continent": "Latin America"
  },
  {
    "id": 62,
    "iso3": "BRA",
    "name": "Brazil",
    "continent": "Latin America"
  },
  {
    "id": 36,
    "iso3": "BHS",
    "name": "Bahamas",
    "continent": "Latin America"
  },
  {
    "id": 52,
    "iso3": "BTN",
    "name": "Bhutan",
    "continent": "Asia"
  },
  {
    "id": 60,
    "iso3": "BVT",
    "name": "Bouvet Island",
    "continent": null
  },
  {
    "id": 58,
    "iso3": "BWA",
    "name": "Botswana",
    "continent": "Africa"
  },
  {
    "id": 112,
    "iso3": "BLR",
    "name": "Belarus",
    "continent": "Eastern Europe"
  },
  {
    "id": 124,
    "iso3": "CAN",
    "name": "Canada",
    "continent": "North America"
  },
  {
    "id": 166,
    "iso3": "CCK",
    "name": "Cocos (Keeling) Islands",
    "continent": "Oceania"
  },
  {
    "id": 180,
    "iso3": "COD",
    "name": "Congo (Kinshasa)",
    "continent": "Africa"
  },
  {
    "id": 140,
    "iso3": "CAF",
    "name": "Central African Republic",
    "continent": "Africa"
  },
  {
    "id": 178,
    "iso3": "COG",
    "name": "Congo (Brazzaville)",
    "continent": "Africa"
  },
  {
    "id": 756,
    "iso3": "CHE",
    "name": "Switzerland",
    "continent": "Western Europe"
  },
  {
    "id": 384,
    "iso3": "CIV",
    "name": "Côte d'Ivoire",
    "continent": "Africa"
  },
  {
    "id": 184,
    "iso3": "COK",
    "name": "Cook Islands",
    "continent": "Oceania"
  },
  {
    "id": 152,
    "iso3": "CHL",
    "name": "Chile",
    "continent": "Latin America"
  },
  {
    "id": 120,
    "iso3": "CMR",
    "name": "Cameroon",
    "continent": "Africa"
  },
  {
    "id": 156,
    "iso3": "CHN",
    "name": "China",
    "continent": "Asia"
  },
  {
    "id": 170,
    "iso3": "COL",
    "name": "Colombia",
    "continent": "Latin America"
  },
  {
    "id": 188,
    "iso3": "CRI",
    "name": "Costa Rica",
    "continent": "Latin America"
  },
  {
    "id": 192,
    "iso3": "CUB",
    "name": "Cuba",
    "continent": "Latin America"
  },
  {
    "id": 132,
    "iso3": "CPV",
    "name": "Cape Verde",
    "continent": "Africa"
  },
  {
    "id": 531,
    "iso3": "CUW",
    "name": "Curaçao",
    "continent": "Latin America"
  },
  {
    "id": 162,
    "iso3": "CXR",
    "name": "Christmas Island",
    "continent": "Oceania"
  },
  {
    "id": 196,
    "iso3": "CYP",
    "name": "Cyprus",
    "continent": "Western Europe"
  },
  {
    "id": 203,
    "iso3": "CZE",
    "name": "Czech Republic",
    "continent": "Western Europe"
  },
  {
    "id": 276,
    "iso3": "DEU",
    "name": "Germany",
    "continent": "Western Europe"
  },
  {
    "id": 262,
    "iso3": "DJI",
    "name": "Djibouti",
    "continent": "Africa"
  },
  {
    "id": 208,
    "iso3": "DNK",
    "name": "Denmark",
    "continent": "Western Europe"
  },
  {
    "id": 212,
    "iso3": "DMA",
    "name": "Dominica",
    "continent": "Latin America"
  },
  {
    "id": 214,
    "iso3": "DOM",
    "name": "Dominican Republic",
    "continent": "Latin America"
  },
  {
    "id": 10,
    "iso3": "DZA",
    "name": "Algeria",
    "continent": "Africa"
  },
  {
    "id": 218,
    "iso3": "ECU",
    "name": "Ecuador",
    "continent": "Latin America"
  },
  {
    "id": 233,
    "iso3": "EST",
    "name": "Estonia",
    "continent": "Eastern Europe"
  },
  {
    "id": 818,
    "iso3": "EGY",
    "name": "Egypt",
    "continent": "Africa"
  },
  {
    "id": 732,
    "iso3": "ESH",
    "name": "Western Sahara",
    "continent": "Africa"
  },
  {
    "id": 232,
    "iso3": "ERI",
    "name": "Eritrea",
    "continent": "Africa"
  },
  {
    "id": 724,
    "iso3": "ESP",
    "name": "Spain",
    "continent": "Western Europe"
  },
  {
    "id": 231,
    "iso3": "ETH",
    "name": "Ethiopia",
    "continent": "Africa"
  },
  {
    "id": 246,
    "iso3": "FIN",
    "name": "Finland",
    "continent": "Western Europe"
  },
  {
    "id": 242,
    "iso3": "FJI",
    "name": "Fiji",
    "continent": "Oceania"
  },
  {
    "id": 238,
    "iso3": "FLK",
    "name": "Falkland Islands",
    "continent": "Latin America"
  },
  {
    "id": 583,
    "iso3": "FSM",
    "name": "Micronesia",
    "continent": "Oceania"
  },
  {
    "id": 234,
    "iso3": "FRO",
    "name": "Faroe Islands",
    "continent": null
  },
  {
    "id": 250,
    "iso3": "FRA",
    "name": "France",
    "continent": "Western Europe"
  },
  {
    "id": 266,
    "iso3": "GAB",
    "name": "Gabon",
    "continent": "Africa"
  },
  {
    "id": 826,
    "iso3": "GBR",
    "name": "United Kingdom",
    "continent": "Western Europe"
  },
  {
    "id": 308,
    "iso3": "GRD",
    "name": "Grenada",
    "continent": "Latin America"
  },
  {
    "id": 268,
    "iso3": "GEO",
    "name": "Georgia",
    "continent": "Asia"
  },
  {
    "id": 254,
    "iso3": "GUF",
    "name": "French Guiana",
    "continent": "Latin America"
  },
  {
    "id": 831,
    "iso3": "GGY",
    "name": "Guernsey",
    "continent": null
  },
  {
    "id": 288,
    "iso3": "GHA",
    "name": "Ghana",
    "continent": "Africa"
  },
  {
    "id": 292,
    "iso3": "GIB",
    "name": "Gibraltar",
    "continent": null
  },
  {
    "id": 304,
    "iso3": "GRL",
    "name": "Greenland",
    "continent": "North America"
  },
  {
    "id": 270,
    "iso3": "GMB",
    "name": "Gambia",
    "continent": "Africa"
  },
  {
    "id": 324,
    "iso3": "GIN",
    "name": "Guinea",
    "continent": "Africa"
  },
  {
    "id": 312,
    "iso3": "GLP",
    "name": "Guadeloupe",
    "continent": "Latin America"
  },
  {
    "id": 226,
    "iso3": "GNQ",
    "name": "Equatorial Guinea",
    "continent": "Africa"
  },
  {
    "id": 300,
    "iso3": "GRC",
    "name": "Greece",
    "continent": "Western Europe"
  },
  {
    "id": 239,
    "iso3": "SGS",
    "name": "South Georgia",
    "continent": null
  },
  {
    "id": 320,
    "iso3": "GTM",
    "name": "Guatemala",
    "continent": "Latin America"
  },
  {
    "id": 316,
    "iso3": "GUM",
    "name": "Guam",
    "continent": "Oceania"
  },
  {
    "id": 624,
    "iso3": "GNB",
    "name": "Guinea-Bissau",
    "continent": "Africa"
  },
  {
    "id": 328,
    "iso3": "GUY",
    "name": "Guyana",
    "continent": "Latin America"
  },
  {
    "id": 344,
    "iso3": "HKG",
    "name": "Hong Kong",
    "continent": "Asia"
  },
  {
    "id": 334,
    "iso3": "HMD",
    "name": "Heard and McDonald Islands",
    "continent": null
  },
  {
    "id": 340,
    "iso3": "HND",
    "name": "Honduras",
    "continent": "Latin America"
  },
  {
    "id": 191,
    "iso3": "HRV",
    "name": "Croatia",
    "continent": "Eastern Europe"
  },
  {
    "id": 332,
    "iso3": "HTI",
    "name": "Haiti",
    "continent": "Latin America"
  },
  {
    "id": 348,
    "iso3": "HUN",
    "name": "Hungary",
    "continent": "Western Europe"
  },
  {
    "id": 360,
    "iso3": "IDN",
    "name": "Indonesia",
    "continent": "Asia"
  },
  {
    "id": 372,
    "iso3": "IRL",
    "name": "Ireland",
    "continent": "Western Europe"
  },
  {
    "id": 376,
    "iso3": "ISR",
    "name": "Israel",
    "continent": "Middle East"
  },
  {
    "id": 833,
    "iso3": "IMN",
    "name": "Isle of Man",
    "continent": null
  },
  {
    "id": 356,
    "iso3": "IND",
    "name": "India",
    "continent": "Indian Subcontinent"
  },
  {
    "id": 368,
    "iso3": "IRQ",
    "name": "Iraq",
    "continent": "Middle East"
  },
  {
    "id": 364,
    "iso3": "IRN",
    "name": "Iran",
    "continent": "Middle East"
  },
  {
    "id": 352,
    "iso3": "ISL",
    "name": "Iceland",
    "continent": "Western Europe"
  },
  {
    "id": 380,
    "iso3": "ITA",
    "name": "Italy",
    "continent": "Western Europe"
  },
  {
    "id": 832,
    "iso3": "JEY",
    "name": "Jersey",
    "continent": null
  },
  {
    "id": 388,
    "iso3": "JAM",
    "name": "Jamaica",
    "continent": "Latin America"
  },
  {
    "id": 400,
    "iso3": "JOR",
    "name": "Jordan",
    "continent": "Middle East"
  },
  {
    "id": 392,
    "iso3": "JPN",
    "name": "Japan",
    "continent": "Asia"
  },
  {
    "id": 404,
    "iso3": "KEN",
    "name": "Kenya",
    "continent": "Africa"
  },
  {
    "id": 417,
    "iso3": "KGZ",
    "name": "Kyrgyzstan",
    "continent": "Asia"
  },
  {
    "id": 116,
    "iso3": "KHM",
    "name": "Cambodia",
    "continent": "Africa"
  },
  {
    "id": 296,
    "iso3": "KIR",
    "name": "Kiribati",
    "continent": null
  },
  {
    "id": 174,
    "iso3": "COM",
    "name": "Comoros",
    "continent": null
  },
  {
    "id": 659,
    "iso3": "KNA",
    "name": "Saint Kitts and Nevis",
    "continent": "Latin America"
  },
  {
    "id": 408,
    "iso3": "PRK",
    "name": "Korea, North",
    "continent": "Asia"
  },
  {
    "id": 410,
    "iso3": "KOR",
    "name": "Korea, South",
    "continent": "Asia"
  },
  {
    "id": 414,
    "iso3": "KWT",
    "name": "Kuwait",
    "continent": "Middle East"
  },
  {
    "id": 136,
    "iso3": "CYM",
    "name": "Cayman Islands",
    "continent": "Latin America"
  },
  {
    "id": 398,
    "iso3": "KAZ",
    "name": "Kazakhstan",
    "continent": "Asia"
  },
  {
    "id": 418,
    "iso3": "LAO",
    "name": "Laos",
    "continent": "Asia"
  },
  {
    "id": 422,
    "iso3": "LBN",
    "name": "Lebanon",
    "continent": "Middle East"
  },
  {
    "id": 662,
    "iso3": "LCA",
    "name": "Saint Lucia",
    "continent": "Latin America"
  },
  {
    "id": 438,
    "iso3": "LIE",
    "name": "Liechtenstein",
    "continent": null
  },
  {
    "id": 144,
    "iso3": "LKA",
    "name": "Sri Lanka",
    "continent": "Indian Subcontinent"
  },
  {
    "id": 430,
    "iso3": "LBR",
    "name": "Liberia",
    "continent": "Africa"
  },
  {
    "id": 426,
    "iso3": "LSO",
    "name": "Lesotho",
    "continent": "Africa"
  },
  {
    "id": 440,
    "iso3": "LTU",
    "name": "Lithuania",
    "continent": "Eastern Europe"
  },
  {
    "id": 442,
    "iso3": "LUX",
    "name": "Luxembourg",
    "continent": "Western Europe"
  },
  {
    "id": 428,
    "iso3": "LVA",
    "name": "Latvia",
    "continent": "Eastern Europe"
  },
  {
    "id": 434,
    "iso3": "LBY",
    "name": "Libya",
    "continent": "Africa"
  },
  {
    "id": 504,
    "iso3": "MAR",
    "name": "Morocco",
    "continent": "Africa"
  },
  {
    "id": 492,
    "iso3": "MCO",
    "name": "Monaco",
    "continent": null
  },
  {
    "id": 498,
    "iso3": "MDA",
    "name": "Moldova",
    "continent": "Eastern Europe"
  },
  {
    "id": 499,
    "iso3": "MNE",
    "name": "Montenegro",
    "continent": "Eastern Europe"
  },
  {
    "id": 663,
    "iso3": "MAF",
    "name": "Saint Martin (French part)",
    "continent": null
  },
  {
    "id": 450,
    "iso3": "MDG",
    "name": "Madagascar",
    "continent": "Africa"
  },
  {
    "id": 584,
    "iso3": "MHL",
    "name": "Marshall Islands",
    "continent": "Africa"
  },
  {
    "id": 807,
    "iso3": "MKD",
    "name": "Macedonia",
    "continent": "Eastern Europe"
  },
  {
    "id": 466,
    "iso3": "MLI",
    "name": "Mali",
    "continent": "Africa"
  },
  {
    "id": 104,
    "iso3": "MMR",
    "name": "Myanmar",
    "continent": "Asia"
  },
  {
    "id": 496,
    "iso3": "MNG",
    "name": "Mongolia",
    "continent": "Asia"
  },
  {
    "id": 446,
    "iso3": "MAC",
    "name": "Macau",
    "continent": "Asia"
  },
  {
    "id": 580,
    "iso3": "MNP",
    "name": "Northern Mariana Islands",
    "continent": "Oceania"
  },
  {
    "id": 474,
    "iso3": "MTQ",
    "name": "Martinique",
    "continent": "Latin America"
  },
  {
    "id": 478,
    "iso3": "MRT",
    "name": "Mauritania",
    "continent": "Africa"
  },
  {
    "id": 500,
    "iso3": "MSR",
    "name": "Montserrat",
    "continent": "Latin America"
  },
  {
    "id": 470,
    "iso3": "MLT",
    "name": "Malta",
    "continent": "Western Europe"
  },
  {
    "id": 480,
    "iso3": "MUS",
    "name": "Mauritius",
    "continent": "Africa"
  },
  {
    "id": 462,
    "iso3": "MDV",
    "name": "Maldives",
    "continent": "Asia"
  },
  {
    "id": 454,
    "iso3": "MWI",
    "name": "Malawi",
    "continent": "Africa"
  },
  {
    "id": 484,
    "iso3": "MEX",
    "name": "Mexico",
    "continent": "North America"
  },
  {
    "id": 458,
    "iso3": "MYS",
    "name": "Malaysia",
    "continent": "Asia"
  },
  {
    "id": 508,
    "iso3": "MOZ",
    "name": "Mozambique",
    "continent": "Africa"
  },
  {
    "id": 516,
    "iso3": "NAM",
    "name": "Namibia",
    "continent": "Africa"
  },
  {
    "id": 540,
    "iso3": "NCL",
    "name": "New Caledonia",
    "continent": "Oceania"
  },
  {
    "id": 562,
    "iso3": "NER",
    "name": "Niger",
    "continent": "Africa"
  },
  {
    "id": 574,
    "iso3": "NFK",
    "name": "Norfolk Island",
    "continent": "Oceania"
  },
  {
    "id": 566,
    "iso3": "NGA",
    "name": "Nigeria",
    "continent": "Africa"
  },
  {
    "id": 558,
    "iso3": "NIC",
    "name": "Nicaragua",
    "continent": "Latin America"
  },
  {
    "id": 528,
    "iso3": "NLD",
    "name": "Netherlands",
    "continent": "Western Europe"
  },
  {
    "id": 578,
    "iso3": "NOR",
    "name": "Norway",
    "continent": "Western Europe"
  },
  {
    "id": 524,
    "iso3": "NPL",
    "name": "Nepal",
    "continent": "Indian Subcontinent"
  },
  {
    "id": 520,
    "iso3": "NRU",
    "name": "Nauru",
    "continent": "Oceania"
  },
  {
    "id": 570,
    "iso3": "NIU",
    "name": "Niue",
    "continent": null
  },
  {
    "id": 554,
    "iso3": "NZL",
    "name": "New Zealand",
    "continent": "Oceania"
  },
  {
    "id": 512,
    "iso3": "OMN",
    "name": "Oman",
    "continent": "Middle East"
  },
  {
    "id": 591,
    "iso3": "PAN",
    "name": "Panama",
    "continent": "Latin America"
  },
  {
    "id": 604,
    "iso3": "PER",
    "name": "Peru",
    "continent": "Latin America"
  },
  {
    "id": 258,
    "iso3": "PYF",
    "name": "French Polynesia",
    "continent": "Oceania"
  },
  {
    "id": 598,
    "iso3": "PNG",
    "name": "Papua New Guinea",
    "continent": "Oceania"
  },
  {
    "id": 608,
    "iso3": "PHL",
    "name": "Philippines",
    "continent": "Asia"
  },
  {
    "id": 586,
    "iso3": "PAK",
    "name": "Pakistan",
    "continent": "Indian Subcontinent"
  },
  {
    "id": 616,
    "iso3": "POL",
    "name": "Poland",
    "continent": "Western Europe"
  },
  {
    "id": 666,
    "iso3": "SPM",
    "name": "Saint Pierre and Miquelon",
    "continent": null
  },
  {
    "id": 612,
    "iso3": "PCN",
    "name": "Pitcairn",
    "continent": null
  },
  {
    "id": 630,
    "iso3": "PRI",
    "name": "Puerto Rico",
    "continent": null
  },
  {
    "id": 275,
    "iso3": "PSE",
    "name": "Palestine",
    "continent": "Asia"
  },
  {
    "id": 620,
    "iso3": "PRT",
    "name": "Portugal",
    "continent": "Western Europe"
  },
  {
    "id": 585,
    "iso3": "PLW",
    "name": "Palau",
    "continent": null
  },
  {
    "id": 600,
    "iso3": "PRY",
    "name": "Paraguay",
    "continent": "Latin America"
  },
  {
    "id": 634,
    "iso3": "QAT",
    "name": "Qatar",
    "continent": "Middle East"
  },
  {
    "id": 638,
    "iso3": "REU",
    "name": "Reunion",
    "continent": null
  },
  {
    "id": 642,
    "iso3": "ROU",
    "name": "Romania",
    "continent": "Eastern Europe"
  },
  {
    "id": 688,
    "iso3": "SRB",
    "name": "Serbia",
    "continent": "Eastern Europe"
  },
  {
    "id": 643,
    "iso3": "RUS",
    "name": "Russian Federation",
    "continent": "Asia"
  },
  {
    "id": 646,
    "iso3": "RWA",
    "name": "Rwanda",
    "continent": "Africa"
  },
  {
    "id": 682,
    "iso3": "SAU",
    "name": "Saudi Arabia",
    "continent": "Middle East"
  },
  {
    "id": 690,
    "iso3": "SYC",
    "name": "Seychelles",
    "continent": null
  },
  {
    "id": 729,
    "iso3": "SDN",
    "name": "Sudan",
    "continent": "Africa"
  },
  {
    "id": 752,
    "iso3": "SWE",
    "name": "Sweden",
    "continent": "Western Europe"
  },
  {
    "id": 702,
    "iso3": "SGP",
    "name": "Singapore",
    "continent": "Asia"
  },
  {
    "id": 654,
    "iso3": "SHN",
    "name": "Saint Helena",
    "continent": null
  },
  {
    "id": 705,
    "iso3": "SVN",
    "name": "Slovenia",
    "continent": "Eastern Europe"
  },
  {
    "id": 744,
    "iso3": "SJM",
    "name": "Svalbard and Jan MayenIslands",
    "continent": null
  },
  {
    "id": 703,
    "iso3": "SVK",
    "name": "Slovakia",
    "continent": "Western Europe"
  },
  {
    "id": 694,
    "iso3": "SLE",
    "name": "Sierra Leone",
    "continent": "Africa"
  },
  {
    "id": 674,
    "iso3": "SMR",
    "name": "San Marino",
    "continent": null
  },
  {
    "id": 686,
    "iso3": "SEN",
    "name": "Senegal",
    "continent": "Africa"
  },
  {
    "id": 706,
    "iso3": "SOM",
    "name": "Somalia",
    "continent": "Africa"
  },
  {
    "id": 740,
    "iso3": "SUR",
    "name": "Suriname",
    "continent": "Latin America"
  },
  {
    "id": 728,
    "iso3": "SSD",
    "name": "South Sudan",
    "continent": "Africa"
  },
  {
    "id": 678,
    "iso3": "STP",
    "name": "Sao Tome and Principe",
    "continent": "Africa"
  },
  {
    "id": 222,
    "iso3": "SLV",
    "name": "El Salvador",
    "continent": "Latin America"
  },
  {
    "id": 534,
    "iso3": "SXM",
    "name": "Sint Maarten",
    "continent": "Latin America"
  },
  {
    "id": 760,
    "iso3": "SYR",
    "name": "Syria",
    "continent": "Middle East"
  },
  {
    "id": 748,
    "iso3": "SWZ",
    "name": "Swaziland",
    "continent": "Africa"
  },
  {
    "id": 796,
    "iso3": "TCA",
    "name": "Turks and Caicos Islands",
    "continent": "Latin America"
  },
  {
    "id": 148,
    "iso3": "TCD",
    "name": "Chad",
    "continent": "Africa"
  },
  {
    "id": 260,
    "iso3": "ATF",
    "name": "French Southern Lands",
    "continent": null
  },
  {
    "id": 768,
    "iso3": "TGO",
    "name": "Togo",
    "continent": "Africa"
  },
  {
    "id": 764,
    "iso3": "THA",
    "name": "Thailand",
    "continent": "Asia"
  },
  {
    "id": 762,
    "iso3": "TJK",
    "name": "Tajikistan",
    "continent": "Asia"
  },
  {
    "id": 772,
    "iso3": "TKL",
    "name": "Tokelau",
    "continent": null
  },
  {
    "id": 626,
    "iso3": "TLS",
    "name": "Timor-Leste",
    "continent": "Oceania"
  },
  {
    "id": 795,
    "iso3": "TKM",
    "name": "Turkmenistan",
    "continent": "Asia"
  },
  {
    "id": 788,
    "iso3": "TUN",
    "name": "Tunisia",
    "continent": "Africa"
  },
  {
    "id": 776,
    "iso3": "TON",
    "name": "Tonga",
    "continent": "Oceania"
  },
  {
    "id": 792,
    "iso3": "TUR",
    "name": "Turkey",
    "continent": "Western Europe"
  },
  {
    "id": 780,
    "iso3": "TTO",
    "name": "Trinidad and Tobago",
    "continent": "Latin America"
  },
  {
    "id": 798,
    "iso3": "TUV",
    "name": "Tuvalu",
    "continent": "Oceania"
  },
  {
    "id": 158,
    "iso3": "TWN",
    "name": "Taiwan",
    "continent": "Asia"
  },
  {
    "id": 834,
    "iso3": "TZA",
    "name": "Tanzania",
    "continent": "Africa"
  },
  {
    "id": 804,
    "iso3": "UKR",
    "name": "Ukraine",
    "continent": "Eastern Europe"
  },
  {
    "id": 800,
    "iso3": "UGA",
    "name": "Uganda",
    "continent": "Africa"
  },
  {
    "id": 581,
    "iso3": "UMI",
    "name": "United States MOI",
    "continent": null
  },
  {
    "id": 840,
    "iso3": "USA",
    "name": "United States of America",
    "continent": "North America"
  },
  {
    "id": 858,
    "iso3": "URY",
    "name": "Uruguay",
    "continent": "Latin America"
  },
  {
    "id": 860,
    "iso3": "UZB",
    "name": "Uzbekistan",
    "continent": "Asia"
  },
  {
    "id": 336,
    "iso3": "VAT",
    "name": "Vatican City",
    "continent": null
  },
  {
    "id": 670,
    "iso3": "VCT",
    "name": "Saint Vincent and theGrenadines",
    "continent": "Latin America"
  },
  {
    "id": 862,
    "iso3": "VEN",
    "name": "Venezuela",
    "continent": "Latin America"
  },
  {
    "id": 1,
    "iso3": "VGB",
    "name": "Virgin Islands, British",
    "continent": null
  },
  {
    "id": 850,
    "iso3": "VIR",
    "name": "Virgin Islands, U.S.",
    "continent": null
  },
  {
    "id": 704,
    "iso3": "VNM",
    "name": "Vietnam",
    "continent": "Asia"
  },
  {
    "id": 548,
    "iso3": "VUT",
    "name": "Vanuatu",
    "continent": "Oceania"
  },
  {
    "id": 876,
    "iso3": "WLF",
    "name": "Wallis and Futuna Islands",
    "continent": null
  },
  {
    "id": 882,
    "iso3": "WSM",
    "name": "Samoa",
    "continent": "Oceania"
  },
  {
    "id": 887,
    "iso3": "YEM",
    "name": "Yemen",
    "continent": "Middle East"
  },
  {
    "id": 175,
    "iso3": "MYT",
    "name": "Mayotte",
    "continent": "Africa"
  },
  {
    "id": 710,
    "iso3": "ZAF",
    "name": "South Africa",
    "continent": "Africa"
  },
  {
    "id": 894,
    "iso3": "ZMB",
    "name": "Zambia",
    "continent": "Africa"
  },
  {
    "id": 716,
    "iso3": "ZWE",
    "name": "Zimbabwe",
    "continent": "Africa"
  }
]
Request Headers