# States

## /states

<mark style="color:blue;">`GET`</mark> `https://api.terminal.africa/v1/states`

This endpoint allows you to retrieve a list of valid states for a given country.

#### Query Parameters

| Name                                            | Type   | Description        |
| ----------------------------------------------- | ------ | ------------------ |
| country\_code<mark style="color:red;">\*</mark> | String | ISO 2 country code |

{% tabs %}
{% tab title="200: OK States in Albania retrieved successfully." %}

```javascript
{
 {
    "status": true,
    "message": "States in Albania retrieved successfully.",
    "data": [
        {
            "name": "Skrapar District",
            "isoCode": "SK",
            "countryCode": "AL",
            "latitude": "40.53499460",
            "longitude": "20.28322170"
        },
        {
            "name": "Kavajë District",
            "isoCode": "KA",
            "countryCode": "AL",
            "latitude": "41.18445290",
            "longitude": "19.56275960"
        },
        {
            "name": "Lezhë District",
            "isoCode": "LE",
            "countryCode": "AL",
            "latitude": "41.78607300",
            "longitude": "19.64607580"
        },
        {
            "name": "Librazhd District",
            "isoCode": "LB",
            "countryCode": "AL",
            "latitude": "41.18292320",
            "longitude": "20.31747690"
        },
        {
            "name": "Korçë District",
            "isoCode": "KO",
            "countryCode": "AL",
            "latitude": "40.59056700",
            "longitude": "20.61689210"
        },
        {
            "name": "Elbasan County",
            "isoCode": "03",
            "countryCode": "AL",
            "latitude": "41.12666720",
            "longitude": "20.23556470"
        },
        {
            "name": "Lushnjë District",
            "isoCode": "LU",
            "countryCode": "AL",
            "latitude": "40.94198300",
            "longitude": "19.69964280"
        },
        {
            "name": "Has District",
            "isoCode": "HA",
            "countryCode": "AL",
            "latitude": "42.79013360",
            "longitude": "-83.61220120"
        },
        {
            "name": "Kukës County",
            "isoCode": "07",
            "countryCode": "AL",
            "latitude": "42.08074640",
            "longitude": "20.41429230"
        },
        {
            "name": "Malësi e Madhe District",
            "isoCode": "MM",
            "countryCode": "AL",
            "latitude": "42.42451730",
            "longitude": "19.61631850"
        },
        {
            "name": "Berat County",
            "isoCode": "01",
            "countryCode": "AL",
            "latitude": "40.69530120",
            "longitude": "20.04496620"
        },
        {
            "name": "Gjirokastër County",
            "isoCode": "05",
            "countryCode": "AL",
            "latitude": "40.06728740",
            "longitude": "20.10452290"
        },
        {
            "name": "Dibër District",
            "isoCode": "DI",
            "countryCode": "AL",
            "latitude": "41.58881630",
            "longitude": "20.23556470"
        },
        {
            "name": "Pogradec District",
            "isoCode": "PG",
            "countryCode": "AL",
            "latitude": "40.90153140",
            "longitude": "20.65562890"
        },
        {
            "name": "Bulqizë District",
            "isoCode": "BU",
            "countryCode": "AL",
            "latitude": "41.49425870",
            "longitude": "20.21471570"
        },
        {
            "name": "Devoll District",
            "isoCode": "DV",
            "countryCode": "AL",
            "latitude": "40.64473470",
            "longitude": "20.95066360"
        },
        {
            "name": "Lezhë County",
            "isoCode": "08",
            "countryCode": "AL",
            "latitude": "41.78137590",
            "longitude": "19.80679160"
        },
        {
            "name": "Dibër County",
            "isoCode": "09",
            "countryCode": "AL",
            "latitude": "41.58881630",
            "longitude": "20.23556470"
        },
        {
            "name": "Shkodër County",
            "isoCode": "10",
            "countryCode": "AL",
            "latitude": "42.15037100",
            "longitude": "19.66393090"
        },
        {
            "name": "Kuçovë District",
            "isoCode": "KC",
            "countryCode": "AL",
            "latitude": "40.78370630",
            "longitude": "19.87823480"
        },
        {
            "name": "Vlorë District",
            "isoCode": "VL",
            "countryCode": "AL",
            "latitude": "40.46606680",
            "longitude": "19.49135600"
        },
        {
            "name": "Krujë District",
            "isoCode": "KR",
            "countryCode": "AL",
            "latitude": "41.50947650",
            "longitude": "19.77107320"
        },
        {
            "name": "Tirana County",
            "isoCode": "11",
            "countryCode": "AL",
            "latitude": "41.24275980",
            "longitude": "19.80679160"
        },
        {
            "name": "Tepelenë District",
            "isoCode": "TE",
            "countryCode": "AL",
            "latitude": "40.29666320",
            "longitude": "20.01816730"
        },
        {
            "name": "Gramsh District",
            "isoCode": "GR",
            "countryCode": "AL",
            "latitude": "40.86698730",
            "longitude": "20.18493230"
        },
        {
            "name": "Delvinë District",
            "isoCode": "DL",
            "countryCode": "AL",
            "latitude": "39.94813640",
            "longitude": "20.09558910"
        },
        {
            "name": "Peqin District",
            "isoCode": "PQ",
            "countryCode": "AL",
            "latitude": "41.04709020",
            "longitude": "19.75023840"
        },
        {
            "name": "Pukë District",
            "isoCode": "PU",
            "countryCode": "AL",
            "latitude": "42.04697720",
            "longitude": "19.89609680"
        },
        {
            "name": "Gjirokastër District",
            "isoCode": "GJ",
            "countryCode": "AL",
            "latitude": "40.06728740",
            "longitude": "20.10452290"
        },
        {
            "name": "Kurbin District",
            "isoCode": "KB",
            "countryCode": "AL",
            "latitude": "41.64126440",
            "longitude": "19.70559500"
        },
        {
            "name": "Kukës District",
            "isoCode": "KU",
            "countryCode": "AL",
            "latitude": "42.08074640",
            "longitude": "20.41429230"
        },
        {
            "name": "Sarandë District",
            "isoCode": "SR",
            "countryCode": "AL",
            "latitude": "39.85921190",
            "longitude": "20.02710010"
        },
        {
            "name": "Përmet District",
            "isoCode": "PR",
            "countryCode": "AL",
            "latitude": "40.23618370",
            "longitude": "20.35173340"
        },
        {
            "name": "Shkodër District",
            "isoCode": "SH",
            "countryCode": "AL",
            "latitude": "42.06929850",
            "longitude": "19.50325590"
        },
        {
            "name": "Fier District",
            "isoCode": "FR",
            "countryCode": "AL",
            "latitude": "40.72750400",
            "longitude": "19.56275960"
        },
        {
            "name": "Kolonjë District",
            "isoCode": "ER",
            "countryCode": "AL",
            "latitude": "40.33732620",
            "longitude": "20.67946760"
        },
        {
            "name": "Berat District",
            "isoCode": "BR",
            "countryCode": "AL",
            "latitude": "40.70863770",
            "longitude": "19.94373140"
        },
        {
            "name": "Korçë County",
            "isoCode": "06",
            "countryCode": "AL",
            "latitude": "40.59056700",
            "longitude": "20.61689210"
        },
        {
            "name": "Fier County",
            "isoCode": "04",
            "countryCode": "AL",
            "latitude": "40.91913920",
            "longitude": "19.66393090"
        },
        {
            "name": "Durrës County",
            "isoCode": "02",
            "countryCode": "AL",
            "latitude": "41.50809720",
            "longitude": "19.61631850"
        },
        {
            "name": "Tirana District",
            "isoCode": "TR",
            "countryCode": "AL",
            "latitude": "41.32754590",
            "longitude": "19.81869820"
        },
        {
            "name": "Vlorë County",
            "isoCode": "12",
            "countryCode": "AL",
            "latitude": "40.15009600",
            "longitude": "19.80679160"
        },
        {
            "name": "Mat District",
            "isoCode": "MT",
            "countryCode": "AL",
            "latitude": "41.59376750",
            "longitude": "19.99732440"
        },
        {
            "name": "Tropojë District",
            "isoCode": "TP",
            "countryCode": "AL",
            "latitude": "42.39821510",
            "longitude": "20.16259550"
        },
        {
            "name": "Mallakastër District",
            "isoCode": "MK",
            "countryCode": "AL",
            "latitude": "40.52733760",
            "longitude": "19.78297910"
        },
        {
            "name": "Mirditë District",
            "isoCode": "MR",
            "countryCode": "AL",
            "latitude": "41.76428600",
            "longitude": "19.90205090"
        },
        {
            "name": "Durrës District",
            "isoCode": "DR",
            "countryCode": "AL",
            "latitude": "41.37065170",
            "longitude": "19.52110630"
        }
    ]
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.terminal.africa/tship/miscallaneous/states.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.