# Countries API

In the Gigastore API, each package relates to a country set. This country set defines the supported countries of this package and is represented by a string identifier.

The number of countries in each country set can be just 1 - for single-country packages - or many such as for worldwide packages or regional packages. 

For each country set, you can check the containing countries using the `countries` endpoint.

The country set of the worldwide package has the identifier `WWW`. To retrieve the included countries, use 

```
GET /gigastore/esim/countries/WWW

Response:
[
    {
        "code": "AU",
        "name": "AU",
        "imageUrl": "/esim/countries/au/flag"
    },
    {
        "code": "AL",
        "name": "AL",
        "imageUrl": "/esim/countries/al/flag"
    },
    ...
]
```

The country set of the Austria package has the identifier `AT`.

```
GET /gigastore/esim/countries/AT

Response:
[
    {
        "code": "AT",
        "name": "AT",
        "imageUrl": "/esim/countries/at/flag"
    }
]
```

The endpoint returns a list of countries, including the **ISO2** code and the **endpoint URL** for the flag of this country.

### Flags

Country flags are provided by the API in **PNG format**. Use the ISO2 code of the country to fetch the image:

```
GET /gigastore/esim/countries/AT/flag
```

### Networks

Each country has one or more providers of network towers (cell towers) supported by Gigastore.

If an eSIM is installed and activated on a user's device, it will automatically try to connect to a supported tower close by. If the user owns a package covering this network, the access is granted and the data used is deducted from the package.

Gigastore can provide clients with a list of supported networks per country on request.