Locations API
Each location API accept keyword as a query param, in order to filter the result (can be used in autocomplete form controls).
Get countries
(only Romania is supported for now)
Example
Request:
curl --request GET 'https://test.bauexpress.ro/api/countries/${country-code}' \
--header 'Authorization: Bearer ${access_token}'
Response:
{
"uuid": "dd0311e7-0c31-11ea-8086-0242ac110002",
"name": "ROMANIA",
"code": "RO"
}
Get counties
Use the country id returned by Get countries service to retrieve counties list (where applicable).
Example
Request:
curl --request GET 'https://test.bauexpress.ro/api/countries/${country-code}/counties' \
--header 'Authorization: Bearer ${access_token}'
Response:
{
"content": [
{
"uuid": "2f04678a-a3ef-11ed-9428-0242ac130002",
"code": "AB",
"name": "Alba"
},
{
"uuid": "2f046b52-a3ef-11ed-9428-0242ac130002",
"code": "AG",
"name": "Arges"
},
{
"uuid": "2f046c59-a3ef-11ed-9428-0242ac130002",
"code": "AR",
"name": "Arad"
},
{
"uuid": "2f046d15-a3ef-11ed-9428-0242ac130002",
"code": "B",
"name": "Bucuresti"
},
{
"uuid": "2f046dcf-a3ef-11ed-9428-0242ac130002",
"code": "BC",
"name": "Bacau"
},
{
"uuid": "2f046e7d-a3ef-11ed-9428-0242ac130002",
"code": "BH",
"name": "Bihor"
},
{
"uuid": "2f046f2c-a3ef-11ed-9428-0242ac130002",
"code": "BN",
"name": "Bistrita-Nasaud"
},
{
"uuid": "2f046fd2-a3ef-11ed-9428-0242ac130002",
"code": "BT",
"name": "Botosani"
},
{
"uuid": "2f04707d-a3ef-11ed-9428-0242ac130002",
"code": "BV",
"name": "Brasov"
},
{
"uuid": "2f047120-a3ef-11ed-9428-0242ac130002",
"code": "BR",
"name": "Braila"
},
{
"uuid": "2f0471c7-a3ef-11ed-9428-0242ac130002",
"code": "BZ",
"name": "Buzau"
},
{
"uuid": "2f04726d-a3ef-11ed-9428-0242ac130002",
"code": "CS",
"name": "Caras-Severin"
},
{
"uuid": "2f047317-a3ef-11ed-9428-0242ac130002",
"code": "CL",
"name": "Calarasi"
},
{
"uuid": "2f0473b4-a3ef-11ed-9428-0242ac130002",
"code": "CJ",
"name": "Cluj"
},
{
"uuid": "2f04744e-a3ef-11ed-9428-0242ac130002",
"code": "CT",
"name": "Constanta"
},
{
"uuid": "2f0474ea-a3ef-11ed-9428-0242ac130002",
"code": "CV",
"name": "Covasna"
},
{
"uuid": "2f047586-a3ef-11ed-9428-0242ac130002",
"code": "DB",
"name": "Dambovita"
},
{
"uuid": "2f04761f-a3ef-11ed-9428-0242ac130002",
"code": "DJ",
"name": "Dolj"
},
{
"uuid": "2f0476b4-a3ef-11ed-9428-0242ac130002",
"code": "GL",
"name": "Galati"
},
{
"uuid": "2f047749-a3ef-11ed-9428-0242ac130002",
"code": "GR",
"name": "Giurgiu"
},
{
"uuid": "2f0477e1-a3ef-11ed-9428-0242ac130002",
"code": "GJ",
"name": "Gorj"
},
{
"uuid": "2f047876-a3ef-11ed-9428-0242ac130002",
"code": "HT",
"name": "Harghita"
},
{
"uuid": "2f04790b-a3ef-11ed-9428-0242ac130002",
"code": "HD",
"name": "Hunedoara"
},
{
"uuid": "2f0479a5-a3ef-11ed-9428-0242ac130002",
"code": "IL",
"name": "Ialomita"
},
{
"uuid": "2f047a3f-a3ef-11ed-9428-0242ac130002",
"code": "IS",
"name": "Iasi"
},
{
"uuid": "2f047ad4-a3ef-11ed-9428-0242ac130002",
"code": "IF",
"name": "Ilfov"
},
{
"uuid": "2f047b6a-a3ef-11ed-9428-0242ac130002",
"code": "MM",
"name": "Maramures"
},
{
"uuid": "2f047bfd-a3ef-11ed-9428-0242ac130002",
"code": "MH",
"name": "Mehedinti"
},
{
"uuid": "2f047c95-a3ef-11ed-9428-0242ac130002",
"code": "MS",
"name": "Mures"
},
{
"uuid": "2f047d2c-a3ef-11ed-9428-0242ac130002",
"code": "NT",
"name": "Neamt"
},
{
"uuid": "2f047dbf-a3ef-11ed-9428-0242ac130002",
"code": "OT",
"name": "Olt"
},
{
"uuid": "2f047e57-a3ef-11ed-9428-0242ac130002",
"code": "PH",
"name": "Prahova"
},
{
"uuid": "2f047eed-a3ef-11ed-9428-0242ac130002",
"code": "SM",
"name": "Satu Mare"
},
{
"uuid": "2f047f82-a3ef-11ed-9428-0242ac130002",
"code": "SJ",
"name": "Salaj"
},
{
"uuid": "2f048015-a3ef-11ed-9428-0242ac130002",
"code": "SB",
"name": "Sibiu"
},
{
"uuid": "2f0480a6-a3ef-11ed-9428-0242ac130002",
"code": "SV",
"name": "Suceava"
},
{
"uuid": "2f04813c-a3ef-11ed-9428-0242ac130002",
"code": "TR",
"name": "Teleorman"
},
{
"uuid": "2f0481ce-a3ef-11ed-9428-0242ac130002",
"code": "TM",
"name": "Timis"
},
{
"uuid": "2f04825d-a3ef-11ed-9428-0242ac130002",
"code": "TL",
"name": "Tulcea"
},
{
"uuid": "2f0482f0-a3ef-11ed-9428-0242ac130002",
"code": "VS",
"name": "Vaslui"
},
{
"uuid": "2f048384-a3ef-11ed-9428-0242ac130002",
"code": "VL",
"name": "Valcea"
},
{
"uuid": "2f048415-a3ef-11ed-9428-0242ac130002",
"code": "VN",
"name": "Vrancea"
}
],
"pageable": {
"sort": {
"unsorted": true,
"sorted": false,
"empty": true
},
"pageSize": 1000,
"pageNumber": 0,
"offset": 0,
"paged": true,
"unpaged": false
},
"totalPages": 1,
"totalElements": 42,
"last": true,
"numberOfElements": 42,
"first": true,
"size": 1000,
"number": 0,
"sort": {
"unsorted": true,
"sorted": false,
"empty": true
},
"empty": false
}
Get localities
Use the country code and county code returned by Get countries and Get counties services to retrieve localities list.
Example
Request:
curl --request GET 'https://test.bauexpress.ro/api/countries/${country-code}/localities?countyCode=${countyCode}' \
--header 'Authorization: Bearer ${access_token}'
Response:
{
"content": [
{
"uuid": "2fad146c-a3ef-11ed-9428-0242ac130002",
"name": "Clapa",
"displayName": "Clapa",
"postalCode": "407551"
},
{
"uuid": "2fad14f6-a3ef-11ed-9428-0242ac130002",
"name": "Cluj-Napoca",
"displayName": "Cluj-Napoca",
"postalCode": "400001"
},
{
"uuid": "2fad497d-a3ef-11ed-9428-0242ac130002",
"name": "Iclod",
"displayName": "Iclod",
"postalCode": "407335"
},
{
"uuid": "2fad4a09-a3ef-11ed-9428-0242ac130002",
"name": "Iclozel",
"displayName": "Iclozel",
"postalCode": "407337"
},
{
"uuid": "2fad5470-a3ef-11ed-9428-0242ac130002",
"name": "Livada (Iclod)",
"displayName": "Livada (Iclod)",
"postalCode": "407338"
},
{
"uuid": "2fad8df6-a3ef-11ed-9428-0242ac130002",
"name": "Razoare(Jud Cluj)",
"displayName": "Razoare(Jud Cluj)",
"postalCode": "407292"
}
],
"pageable": {
"sort": {
"unsorted": true,
"sorted": false,
"empty": true
},
"pageSize": 10,
"pageNumber": 0,
"offset": 0,
"paged": true,
"unpaged": false
},
"totalPages": 1,
"totalElements": 6,
"last": true,
"numberOfElements": 6,
"first": true,
"size": 10,
"number": 0,
"sort": {
"unsorted": true,
"sorted": false,
"empty": true
},
"empty": false
}
Get streets
Use the locality id returned by Get localities service to retrieve streets list.
Example
Request:
curl --location --request GET 'https://test.bauexpress.ro/api/localities/${locality-id}/streets'\
--header 'Authorization: Bearer ${access_token}'
Response:
{
"content": [
{
"uuid": "32f31d6f-a3ef-11ed-9428-0242ac130002",
"name": "Artelor",
"postalCode": "400439"
},
{
"uuid": "32f31ec7-a3ef-11ed-9428-0242ac130002",
"name": "Atelierului",
"postalCode": "400237"
},
{
"uuid": "32f38f23-a3ef-11ed-9428-0242ac130002",
"name": "Dealul Fanatelor",
"postalCode": "400643"
},
{
"uuid": "32f3aa7b-a3ef-11ed-9428-0242ac130002",
"name": "Fanatelor",
"postalCode": "400646"
},
{
"uuid": "32f40a4f-a3ef-11ed-9428-0242ac130002",
"name": "Margaretelor",
"postalCode": "400623"
},
{
"uuid": "32f449c9-a3ef-11ed-9428-0242ac130002",
"name": "Panselutelor",
"postalCode": "400623"
},
{
"uuid": "32f46581-a3ef-11ed-9428-0242ac130002",
"name": "Portelanului",
"postalCode": "400061"
},
{
"uuid": "32f495d0-a3ef-11ed-9428-0242ac130002",
"name": "Sindicatelor",
"postalCode": "400029"
},
{
"uuid": "32f4a763-a3ef-11ed-9428-0242ac130002",
"name": "Stelutei",
"postalCode": "400254"
},
{
"uuid": "32f4b32b-a3ef-11ed-9428-0242ac130002",
"name": "Teleorman",
"postalCode": "400573"
}
],
"pageable": {
"sort": {
"unsorted": true,
"sorted": false,
"empty": true
},
"pageSize": 10,
"pageNumber": 0,
"offset": 0,
"paged": true,
"unpaged": false
},
"totalPages": 2,
"totalElements": 11,
"last": false,
"numberOfElements": 10,
"first": true,
"size": 10,
"number": 0,
"sort": {
"unsorted": true,
"sorted": false,
"empty": true
},
"empty": false
}