Skip to content

FIAS Entity Search (Regions, Streets, Districts)

Search for FIAS address system elements: regions, cities, districts, streets, localities, and additional territories. Supports filtering by the hierarchy of address objects.

URL

Method: GET

  • Production: https://registry.wallet.kvell.group/reg2/dictionary/fias/{element}

Request parameters

Name Type Required Description
element string (path) Yes FIAS element: additional_area, city, district, intra_area (localities), region, settlement, street
search string Yes Search string
regionId uuid No Region ID (UUID)
districtId uuid No District ID (UUID)
cityId uuid No City ID (UUID)
settlementId uuid No Settlement ID (UUID)
intraAreaId uuid No Locality ID (UUID)
streetId uuid No Street ID (UUID)
additionalAreaId uuid No Additional territory ID (UUID)

Request example

GET https://registry.wallet.kvell.group/reg2/dictionary/fias/{element}?search=Москва

Request headers

Name Type Required Description
X-Api-Key string Yes Unique identifier (UUID)

Response

Response example

[
  {
    "id": "9e79f949-9a68-48ff-b2bb-36958c1d5038",
    "name": "Москва",
    "type": "city",
    "prefix": "г",
    "postalCode": "125130",
    "kladrCode": "9400000000000",
    "2Gis": true
  }
]

Response parameters

Name Type Description
id uuid Object identifier
name string Object name
type string Object type
prefix string Prefix
postalCode string Postal code
kladrCode string KLADR code
okatoCode string OKATO code
2Gis boolean Present in 2GIS