Skip to content

POI Category

Pricing Tier Licence Type

POI Category API returns a list of all recorded POI categories.
A POI Category is the lowest level of classification of a POI.

Request

Endpoint

GET /v4/{billing_plan}/account/{account_id}/dictionary/poi_category

Path Parameters

Name                       Description Type Examples
*{billing_plan} Billing plan to be applied to the call. string licence
ondemand
*{account_id} Provided identifier of the account. string

Header Parameters

Name                          Description Type Examples                          Default
*x-api-key Provided API key {x_api_key} that allows authentication. string
*Authorization Provided token {jwt_bearer} that allows authorization. string Bearer {jwt_bearer}
Accept-Language Translate the requested dictionary entries in a language specified in in ISO_639-1 standard format. string it
fr
en

Query Parameters

Name Description Type Examples Default
industry Filter by Industry. string Dictionary
page Requested page number for paginated results. int 1
page_size Requested page size for paginated results in the range [1, 100]. int 25
Example
curl -X GET 'https://api.datappeal.io/v4/{billing_plan}/account/{account_id}/dictionary/poi_category' \
-H 'x-api-key: {x_api_key}' \
-H 'Authorization: Bearer {jwt_bearer}' \

Response

Status

Status Description
200 POI Category data has been successfully returned.

Body

POICategories

Field Description Type
*results Paginated list of POI categories. array[DictionaryEntry]
paging Response pagination. Paging
DictionaryEntry
Field Description Type Examples
*id Descriptive identifier of the entry. string accessibility
family
accounting
apartments
agriculture
*name Full name of the entry. string Accessibility
Families
Accounting
Apartments
Agriculture
*assets Set of images related to the entry. Assets
Assets
Field Description Type Examples
*icon Icon corresponding to the parent entry. Icon
Icon
Field Description Type Examples
*material_io Material Icon identifier. string loyalty
favorite
storefront
house
agriculture
Paging
Field Description Type
last A relative URI to the last page. string
first A relative URI to the first page. string
prev A relative URI to the previous page. string
next A relative URI to the next page. string
current A relative URI to the current page. string
pages A set of relative URIs calculated around the current page. Page
elements All indexes shown on the current page. array[int]
total The number of all elements that API can retrieve. int
size The selected page size. int
Page
Field Description Type
number Number of the page. int
uri URI of the page. string
Example
{
    "results": [
        {
            "id": "accounting",
            "name": "Accounting",
            "assets": {
                "icon": {
                    "material_io": "storefront"
                }
            }
        },
        {
            "id": "agriculture-cooperative",
            "name": "Agricultural cooperatives",
            "assets": {
                "icon": {
                    "material_io": "agriculture"
                }
            }
        },
        {
            "id": "agriculture-greenhouse",
            "name": "Greenhouse",
            "assets": {
                "icon": {
                    "material_io": "agriculture"
                }
            }
        },
        {
            "id": "agriculture-machines",
            "name": "Agricultural machinery",
            "assets": {
                "icon": {
                    "material_io": "agriculture"
                }
            }
        },
        {
            "id": "agriculture-market",
            "name": "Market",
            "assets": {
                "icon": {
                    "material_io": "agriculture"
                }
            }
        },
        {
            "id": "agriculture-production",
            "name": "Production",
            "assets": {
                "icon": {
                    "material_io": "agriculture"
                }
            }
        },
        {
            "id": "agriculture-professional",
            "name": "Professional",
            "assets": {
                "icon": {
                    "material_io": "agriculture"
                }
            }
        },
        {
            "id": "agriculture-supply",
            "name": "Supply",
            "assets": {
                "icon": {
                    "material_io": "agriculture"
                }
            }
        },
        {
            "id": "airlines",
            "name": "Airlines",
            "assets": {
                "icon": {
                    "material_io": "flight"
                }
            }
        },
        {
            "id": "airport",
            "name": "Airport",
            "assets": {
                "icon": {
                    "material_io": "storefront"
                }
            }
        },
        {
            "id": "amusement_park",
            "name": "Amusement park",
            "assets": {
                "icon": {
                    "material_io": "storefront"
                }
            }
        },
        {
            "id": "aquarium",
            "name": "Aquarium",
            "assets": {
                "icon": {
                    "material_io": "account_balance"
                }
            }
        },
        {
            "id": "archaeological_area",
            "name": "Archeological area",
            "assets": {
                "icon": {
                    "material_io": "account_balance"
                }
            }
        },
        {
            "id": "archive",
            "name": "Archive",
            "assets": {
                "icon": {
                    "material_io": "menu_book"
                }
            }
        },
        {
            "id": "arena",
            "name": "Arena",
            "assets": {
                "icon": {
                    "material_io": "account_balance"
                }
            }
        },
        {
            "id": "art_gallery",
            "name": "Art gallery",
            "assets": {
                "icon": {
                    "material_io": "storefront"
                }
            }
        },
        {
            "id": "art_museum",
            "name": "Art museum",
            "assets": {
                "icon": {
                    "material_io": "account_balance"
                }
            }
        },
        {
            "id": "atm",
            "name": "Atm",
            "assets": {
                "icon": {
                    "material_io": "atm"
                }
            }
        },
        {
            "id": "attraction",
            "name": "Attraction",
            "assets": {
                "icon": {
                    "material_io": "account_balance"
                }
            }
        },
        {
            "id": "bakery",
            "name": "Bakery",
            "assets": {
                "icon": {
                    "material_io": "store"
                }
            }
        },
        {
            "id": "bank",
            "name": "Bank",
            "assets": {
                "icon": {
                    "material_io": "storefront"
                }
            }
        },
        {
            "id": "banking",
            "name": "Banking",
            "assets": {
                "icon": {
                    "material_io": "storefront"
                }
            }
        },
        {
            "id": "banking-advisor",
            "name": "Advisor",
            "assets": {
                "icon": {
                    "material_io": "account_balance"
                }
            }
        },
        {
            "id": "banking-atm",
            "name": "Atm",
            "assets": {
                "icon": {
                    "material_io": "account_balance"
                }
            }
        },
        {
            "id": "banking-bank",
            "name": "Bank",
            "assets": {
                "icon": {
                    "material_io": "account_balance"
                }
            }
        }
    ],
    "paging": {
        "last": "/dictionary/poi_category?page=25&page_size=25",
        "first": "/dictionary/poi_category?page=1&page_size=25",
        "prev": null,
        "next": "/dictionary/poi_category?page=2&page_size=25",
        "current": "/dictionary/poi_category?page=1&page_size=25",
        "pages": [
            {
                "number": 1,
                "uri": "/dictionary/poi_category?page=1&page_size=25"
            },
            {
                "number": 2,
                "uri": "/dictionary/poi_category?page=2&page_size=25"
            },
            {
                "number": 3,
                "uri": "/dictionary/poi_category?page=3&page_size=25"
            },
            {
                "number": 4,
                "uri": "/dictionary/poi_category?page=4&page_size=25"
            },
            {
                "number": 5,
                "uri": "/dictionary/poi_category?page=5&page_size=25"
            }
        ],
        "elements": [
            1,
            2,
            3,
            4,
            5,
            6,
            7,
            8,
            9,
            10,
            11,
            12,
            13,
            14,
            15,
            16,
            17,
            18,
            19,
            20,
            21,
            22,
            23,
            24,
            25
        ],
        "total": 604,
        "size": 25
    }
}