API endpoints
- https://api.bisnode.fi/people/info/v2/location-with-address - production environment
- https://api-test.bisnode.fi/people/info/v2/location-with-address - test environment
API response
| Data element | Description |
|---|---|
| BisnodeId | The unique person id. e.g. FI2101005061055 |
| x | Longitude. e.g. 24.942014 |
| y | Latitude. e.g. 60.196467 |
API request parameters
| Parameter | Description | |
|---|---|---|
| streetAddress | example: Kumpulantie 3 | X |
| postalCode | example: 00520 | X |
| radius | Radius of circle in meters. Max 5000 meters. | X |
| coordinateSystem | Wgs84 (default) or Tm35Fin | |
| X = Mandatory | ||
https://api-test.bisnode.fi/people/info/v2/location-with-address?streetAddress={streetAddress}&postalCode={postalCode}&radius={radius}&coordinateSystem={coordinateSystem}
cURL request example
curl 'https://api-test.bisnode.fi/people/info/v2/location-with-address?streetAddress=Kumpulantie%203&postalCode=00520&radius=25' -H 'x-api-key: 1234567890ABC'
API request and response example
GET https://api-test.bisnode.fi/people/info/v2/location-with-address?streetAddress=Kumpulantie%203&postalCode=00520&radius=25
Successful request and the API return results in JSON format.
{
"coordinateSystem": "Wgs84",
"count": 11,
"errorMessage": null,
"hits": [
{
"bisnodeId": "FI2101005061055",
"x": 24.942014,
"y": 60.196467,
"distanceInMeters": 0
},
{
"bisnodeId": "FI2101005066333",
"x": 24.942014,
"y": 60.196467,
"distanceInMeters": 0
},
{
"bisnodeId": "FI2101010969656",
"x": 24.942014,
"y": 60.196467,
"distanceInMeters": 0
},
{
"bisnodeId": "FI2101010969657",
"x": 24.942014,
"y": 60.196467,
"distanceInMeters": 0
},
{
"bisnodeId": "FI2101010969658",
"x": 24.942014,
"y": 60.196467,
"distanceInMeters": 0
},
{
"bisnodeId": "FI2101010969659",
"x": 24.942014,
"y": 60.196467,
"distanceInMeters": 0
},
{
"bisnodeId": "FI2101010969660",
"x": 24.942014,
"y": 60.196467,
"distanceInMeters": 0
},
{
"bisnodeId": "FI2101010969661",
"x": 24.942014,
"y": 60.196467,
"distanceInMeters": 0
},
{
"bisnodeId": "FI2101010969662",
"x": 24.942014,
"y": 60.196467,
"distanceInMeters": 0
},
{
"bisnodeId": "FI2101010969663",
"x": 24.942014,
"y": 60.196467,
"distanceInMeters": 0
},
{
"bisnodeId": "FI2101010969666",
"x": 24.942014,
"y": 60.196467,
"distanceInMeters": 0
}
]
}