List countries with filtering, sorting, search and pagination

GEThttps://api.testingapis.com/api/CountriesSign in to see this endpoint's URL

Query parameters (all optional):

limit: page size, 1-100 (default: all records).

page: 1-based page number; only applies together with limit.

offset: number of records to skip (used when page is not given).

sort: property name to sort by, e.g. sort=title.

order: asc (default) or desc.

q: case-insensitive search across title, name, body, description and text fields.

Any other property name filters by exact, case-insensitive value, e.g. ?department=engineering.

Totals are returned in the X-Total-Count, X-Page, X-Per-Page and X-Total-Pages response headers.

Responses

200: The matching records (an empty array when nothing matches).

Example

Request

curl -X GET "https://api.testingapis.com/api/Countries?limit=2" \
  -H "X-TestingApis-Key: YOUR_API_KEY"

Response200 OK

X-Total-Count: 33
X-Page: 1
X-Per-Page: 2
X-Total-Pages: 17

[
  {
    "id": 1,
    "name": "United States",
    "code": "US",
    "code3": "USA",
    "capital": "Washington, D.C.",
    "region": "Americas",
    "population": 331900000,
    "area": 9833520,
    "currency": {"code": "USD", "name": "United States dollar", "symbol": "$"},
    "languages": ["English"],
… (3 more lines)

The parameters, request and response examples and the live Try it panel for this endpoint are for signed-in members. Accounts are free and take a few seconds to create.

Try itSign-in requiredUses your key

api.testingapis.com

curl 'https://api.testingapis.com/api/Countries?limit=2' \
  -H 'X-TestingApis-Key: YOUR_API_KEY'

const res = await fetch("https://api.testingapis.com/api/Countries?limit=2", {
  headers: {
    "X-TestingApis-Key": "YOUR_API_KEY",
  },
});
console.log(res.status, await res.text());

const res = await fetch("https://api.testingapis.com/api/Countries?limit=2", {
  headers: {
    "X-TestingApis-Key": "YOUR_API_KEY",
  },
});
const body: string = await res.text();
console.log(res.status, body);

import requests

res = requests.get(
    "https://api.testingapis.com/api/Countries?limit=2",
    headers={
        "X-TestingApis-Key": "YOUR_API_KEY",
    },
)
print(res.status_code, res.text)

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://api.testingapis.com/api/Countries?limit=2");
request.Headers.TryAddWithoutValidation("X-TestingApis-Key", "YOUR_API_KEY");
using var response = await client.SendAsync(request);
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.testingapis.com/api/Countries?limit=2"))
                .header("X-TestingApis-Key", "YOUR_API_KEY")
                .GET()
                .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode() + " " + response.body());
    }
}

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.testingapis.com/api/Countries?limit=2", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-TestingApis-Key", "YOUR_API_KEY")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, err := io.ReadAll(res.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(res.StatusCode, string(data))
}

GEThttps://api.testingapis.com/api/Countries?limit=2

List countries with filtering, sorting, search and pagination

Responses

Example

Related