[GET] Get Countries

Modified on Tue, 11 Feb at 3:45 AM

https://api.s7risk.com

The Incident API provides well constructed high-quality, highly-tailored and scalable threat intelligence data.

`GET /geography/countries`Get countries

This endpoint gets all available countries. The countries returned can be filtered in scope by adding query parameters to your request.

HTTP Request

curl -X GET 'https://api.s7risk.com/geography/countries' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {{YOUR_AUTHENTICATION_TOKEN}}' \
  -d 'search=United States' \
  -d 'area=in:[[[-100.01812173401174,33.81520071685678],[-76.79736397186467,32.46264362887847]]]' \
  -d 'sort=name:asc' \
  -d 'page=1' \
  -d 'pageSize=10' \
  --compressed

Headers

Name	Type	Required	Description
`Authorization`	string	✔	Your authentication token

Query Parameters

Name	Type	Description
`search`	string	Search countries using the given search term
`area`	string	Filter by geometry
`sort`	string	Sort the results. Available options are `name:asc` or `name:desc`.
`page`	int	A paginated result set. Defaults to `1`
`pageSize`	int	A limited result set. Defaults to `100`

HTTP Response

{
  "status": "success",
  "data": {
    "countries": [
      {
        "code": "UMI",
        "alpha2": "UM",
        "name": "United States Minor Outlying Islands",
        "continent": {
          "code": "NA",
          "name": "North America"
        }
      },
      {
        "code": "USA",
        "alpha2": "US",
        "name": "United States",
        "continent": {
          "code": "NA",
          "name": "North America"
        }
      },
      {
        "code": "VIR",
        "alpha2": "VI",
        "name": "United States Virgin Islands",
        "continent": {
          "code": "NA",
          "name": "North America"
        }
      }
    ]
  }
}

Success

Code	Status	Description
200	Success	Returns a body containing all valid tags

Errors

Code	Status	Description
401	Unauthorized	Expired or Invalid Authentication token
422	Unprocessable Entity	Incorrect or invalid search parameter