Skip to content

Persons

Search and fetch persons with their roles, ownership and properties.

Method Path Description
GET /person/search Search person by name
GET /person/{itemId} Find person by id

Search person by name

GET /person/search

Scope: persons · Quota: counts against the quota

Parameters

Parameter Type Description
q
required
string Person name, 3 to 100 characters.
page integer Page number. A search has at most 10 pages: past page 10, items is empty and only count is given. default 1
limit integer Results per page. default 10 · 1–10

Example

Terminal window
curl "https://ownr.dk/api/v2/person/search?q=Jesper%20Buch" \
-H "Authorization: Bearer ACCESS_TOKEN"
{
"status": "success",
"data": {
"items": [
{
"item": {
"id": 4004068725,
"slug": "person",
"url": "/api/v2/person/4004068725",
"name": "Jesper Buch"
},
"company_count": 4,
"relation_count": 3
}
],
"count": 1,
"page": 1,
"pageCount": 1,
"nextPageUrl": null,
"prevPageUrl": null
}
}

Fields in the response

Field Type Description
data object
data.items array<object>
data.items[].item object
data.items[].item.id integer e.g. 4004068725
data.items[].item.slug string default person
data.items[].item.url string e.g. /api/v2/person/4004068725
data.items[].item.name string e.g. Jesper Buch
data.items[].company_count integer e.g. 4
data.items[].relation_count integer e.g. 3
data.count integer The total number of records in the result set. e.g. 1
data.page integer The current page displayed. e.g. 1
data.pageCount integer Total number of pages. e.g. 1
data.nextPageUrl string
data.prevPageUrl string

Errors

Status Meaning
400 Empty query supplied
401 Missing, invalid or expired access token
403 The access token does not have the scope this endpoint needs
429 Call quota or hourly rate limit reached. Retry-After gives the seconds to wait; when the quota is used up, error.upgrade_url links to where the tier is upgraded

Find person by id

GET /person/{itemId}

Scope: persons · Quota: counts against the quota

Parameters

Parameter Type Description
itemId
in path, required
integer
beneficial_purpose string Purpose of the beneficial owners lookup, see /beneficial-owners/purposes. Required together with beneficial_accept=1 to see beneficial owners.
beneficial_accept integer Pass 1 to confirm the declaration of the chosen beneficial_purpose, see /beneficial-owners/purposes. Every lookup is logged with its purpose.

Example

Terminal window
curl "https://ownr.dk/api/v2/person/4004068725" \
-H "Authorization: Bearer ACCESS_TOKEN"
Show example response
{
"status": "success",
"data": {
"id": 4000528644,
"slug": "person",
"url": "/person/4000528644",
"name": "Mick Stjernelykke",
"address": {
"id": "0a3f5088-0f97-32b8-e044-0003ba298018",
"slug": "property",
"url": "/api/v2/property/0a3f5088-0f97-32b8-e044-0003ba298018",
"address_1": "Tybrindvej 10",
"address_2": "Husby",
"zip": "5592",
"city": "Ejby",
"country": "DK",
"restricted": [
"id",
"url",
"address_1",
"address_2"
]
},
"owned_companies": {
"legal": [
{
"item": {
"id": 36473606,
"slug": "company",
"url": "/api/v2/company/36473606",
"name": "WEB CODERS ApS"
},
"notes": "33.34-49.99%"
}
],
"beneficial": [
{
"item": {
"id": 36473606,
"slug": "company",
"url": "/api/v2/company/36473606",
"name": "WEB CODERS ApS"
},
"notes": "33,33%"
}
],
"ultimate": [
{
"item": {
"id": 36473606,
"slug": "company",
"url": "/api/v2/company/36473606",
"name": "WEB CODERS ApS"
},
"notes": ""
}
]
},
"roles": {
"director": [
{
"item": {
"id": 36473606,
"slug": "company",
"url": "/api/v2/company/36473606",
"name": "WEB CODERS ApS"
},
"notes": ""
}
],
"representative": [
{
"item": {
"id": 36473606,
"slug": "company",
"url": "/api/v2/company/36473606",
"name": "WEB CODERS ApS"
},
"notes": ""
}
],
"store_manager": [
{
"item": {
"id": 36473606,
"slug": "company",
"url": "/api/v2/company/36473606",
"name": "WEB CODERS ApS"
},
"notes": ""
}
],
"board_member": [
{
"item": {
"id": 36473606,
"slug": "company",
"url": "/api/v2/company/36473606",
"name": "WEB CODERS ApS"
},
"notes": ""
}
]
},
"properties": [
{
"item": {
"id": "0a3f5088-0f97-32b8-e044-0003ba298018",
"slug": "property",
"url": "/api/v2/property/0a3f5088-0f97-32b8-e044-0003ba298018",
"address_1": "Tybrindvej 10",
"address_2": "Husby",
"zip": "5592",
"city": "Ejby",
"country": "DK",
"restricted": [
"id",
"url",
"address_1",
"address_2"
]
},
"notes": ""
}
]
}
}

Fields in the response

Show all 78 fields
Field Type Description
data object
data.id integer e.g. 4000528644
data.slug string default person
data.url string e.g. /person/4000528644
data.name string e.g. Mick Stjernelykke
data.address object
data.address.id string e.g. 0a3f5088-0f97-32b8-e044-0003ba298018
data.address.slug string default property
data.address.url string e.g. /api/v2/property/0a3f5088-0f97-32b8-e044-0003ba298018
data.address.address_1 string e.g. Tybrindvej 10
data.address.address_2 string e.g. Husby
data.address.zip string e.g. 5592
data.address.city string e.g. Ejby
data.address.country string e.g. DK
data.address.restricted array<string> Fields your plan does not include; each is null. Present only when something is hidden.
data.owned_companies object
data.owned_companies.legal array<object>
data.owned_companies.legal[].item object
data.owned_companies.legal[].item.id integer e.g. 36473606
data.owned_companies.legal[].item.slug string default company
data.owned_companies.legal[].item.url string e.g. /api/v2/company/36473606
data.owned_companies.legal[].item.name string e.g. WEB CODERS ApS
data.owned_companies.legal[].notes string e.g. 33.34-49.99%
data.owned_companies.beneficial array<object> Requires beneficial_purpose and beneficial_accept=1. Without them, with an invalid purpose or when beneficial owners are not enabled for your account, the array holds a single notice item with item.slug = beneficial_owners_purposes, item.url pointing to /beneficial-owners/purposes and the reason in notes, e.g. To see beneficial owners pass beneficial_purpose and beneficial_accept=1. Allowed purposes: /api/v2/beneficial-owners/purposes or Beneficial owners are not enabled for your account..
data.owned_companies.beneficial[].item object
data.owned_companies.beneficial[].item.id integer e.g. 36473606
data.owned_companies.beneficial[].item.slug string default company
data.owned_companies.beneficial[].item.url string e.g. /api/v2/company/36473606
data.owned_companies.beneficial[].item.name string e.g. WEB CODERS ApS
data.owned_companies.beneficial[].notes string e.g. 33,33%
data.owned_companies.ultimate array<object>
data.owned_companies.ultimate[].item object
data.owned_companies.ultimate[].item.id integer e.g. 36473606
data.owned_companies.ultimate[].item.slug string default company
data.owned_companies.ultimate[].item.url string e.g. /api/v2/company/36473606
data.owned_companies.ultimate[].item.name string e.g. WEB CODERS ApS
data.owned_companies.ultimate[].notes string
data.roles object
data.roles.director array<object>
data.roles.director[].item object
data.roles.director[].item.id integer e.g. 36473606
data.roles.director[].item.slug string default company
data.roles.director[].item.url string e.g. /api/v2/company/36473606
data.roles.director[].item.name string e.g. WEB CODERS ApS
data.roles.director[].notes string
data.roles.representative array<object>
data.roles.representative[].item object
data.roles.representative[].item.id integer e.g. 36473606
data.roles.representative[].item.slug string default company
data.roles.representative[].item.url string e.g. /api/v2/company/36473606
data.roles.representative[].item.name string e.g. WEB CODERS ApS
data.roles.representative[].notes string
data.roles.store_manager array<object>
data.roles.store_manager[].item object
data.roles.store_manager[].item.id integer e.g. 36473606
data.roles.store_manager[].item.slug string default company
data.roles.store_manager[].item.url string e.g. /api/v2/company/36473606
data.roles.store_manager[].item.name string e.g. WEB CODERS ApS
data.roles.store_manager[].notes string
data.roles.board_member array<object>
data.roles.board_member[].item object
data.roles.board_member[].item.id integer e.g. 36473606
data.roles.board_member[].item.slug string default company
data.roles.board_member[].item.url string e.g. /api/v2/company/36473606
data.roles.board_member[].item.name string e.g. WEB CODERS ApS
data.roles.board_member[].notes string
data.properties array<object> Properties this person holds an access/ownership record on. item.id/item.url/item.address_1/item.address_2 are null and named in item.restricted when the caller doesn’t hold at least a Premium plan. Shown here in full, as if that plan were held.
data.properties[].item object
data.properties[].item.id string e.g. 0a3f5088-0f97-32b8-e044-0003ba298018
data.properties[].item.slug string default property
data.properties[].item.url string e.g. /api/v2/property/0a3f5088-0f97-32b8-e044-0003ba298018
data.properties[].item.address_1 string e.g. Tybrindvej 10
data.properties[].item.address_2 string e.g. Husby
data.properties[].item.zip string e.g. 5592
data.properties[].item.city string e.g. Ejby
data.properties[].item.country string e.g. DK
data.properties[].item.restricted array<string> Fields your plan does not include; each is null. Present only when something is hidden.
data.properties[].notes string

Errors

Status Meaning
400 Invalid ID supplied
401 Missing, invalid or expired access token
403 The access token does not have the scope this endpoint needs
404 Record not found
429 Call quota or hourly rate limit reached. Retry-After gives the seconds to wait; when the quota is used up, error.upgrade_url links to where the tier is upgraded