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/searchScope: persons · Quota: counts against the quota
Parameters
| Parameter | Type | Description |
|---|---|---|
qrequired |
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
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. |
array<object> | |
data. |
object | |
data. |
integer | e.g. 4004068725 |
data. |
string | default person |
data. |
string | e.g. /api/v2/person/4004068725 |
data. |
string | e.g. Jesper Buch |
data. |
integer | e.g. 4 |
data. |
integer | e.g. 3 |
data. |
integer | The total number of records in the result set. e.g. 1 |
data. |
integer | The current page displayed. e.g. 1 |
data. |
integer | Total number of pages. e.g. 1 |
data. |
string | |
data. |
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 |
|---|---|---|
itemin path, required |
integer | |
beneficial_ |
string | Purpose of the beneficial owners lookup, see /beneficial-owners/purposes. Required together with beneficial_accept=1 to see beneficial owners. |
beneficial_ |
integer | Pass 1 to confirm the declaration of the chosen beneficial_purpose, see /beneficial-owners/purposes. Every lookup is logged with its purpose. |
Example
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. |
integer | e.g. 4000528644 |
data. |
string | default person |
data. |
string | e.g. /person/4000528644 |
data. |
string | e.g. Mick Stjernelykke |
data. |
object | |
data. |
string | e.g. 0a3f5088-0f97-32b8-e044-0003ba298018 |
data. |
string | default property |
data. |
string | e.g. /api/v2/property/0a3f5088-0f97-32b8-e044-0003ba298018 |
data. |
string | e.g. Tybrindvej 10 |
data. |
string | e.g. Husby |
data. |
string | e.g. 5592 |
data. |
string | e.g. Ejby |
data. |
string | e.g. DK |
data. |
array<string> | Fields your plan does not include; each is null. Present only when something is hidden. |
data. |
object | |
data. |
array<object> | |
data. |
object | |
data. |
integer | e.g. 36473606 |
data. |
string | default company |
data. |
string | e.g. /api/v2/company/36473606 |
data. |
string | e.g. WEB CODERS ApS |
data. |
string | e.g. 33.34-49.99% |
data. |
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. |
object | |
data. |
integer | e.g. 36473606 |
data. |
string | default company |
data. |
string | e.g. /api/v2/company/36473606 |
data. |
string | e.g. WEB CODERS ApS |
data. |
string | e.g. 33,33% |
data. |
array<object> | |
data. |
object | |
data. |
integer | e.g. 36473606 |
data. |
string | default company |
data. |
string | e.g. /api/v2/company/36473606 |
data. |
string | e.g. WEB CODERS ApS |
data. |
string | |
data. |
object | |
data. |
array<object> | |
data. |
object | |
data. |
integer | e.g. 36473606 |
data. |
string | default company |
data. |
string | e.g. /api/v2/company/36473606 |
data. |
string | e.g. WEB CODERS ApS |
data. |
string | |
data. |
array<object> | |
data. |
object | |
data. |
integer | e.g. 36473606 |
data. |
string | default company |
data. |
string | e.g. /api/v2/company/36473606 |
data. |
string | e.g. WEB CODERS ApS |
data. |
string | |
data. |
array<object> | |
data. |
object | |
data. |
integer | e.g. 36473606 |
data. |
string | default company |
data. |
string | e.g. /api/v2/company/36473606 |
data. |
string | e.g. WEB CODERS ApS |
data. |
string | |
data. |
array<object> | |
data. |
object | |
data. |
integer | e.g. 36473606 |
data. |
string | default company |
data. |
string | e.g. /api/v2/company/36473606 |
data. |
string | e.g. WEB CODERS ApS |
data. |
string | |
data. |
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. |
object | |
data. |
string | e.g. 0a3f5088-0f97-32b8-e044-0003ba298018 |
data. |
string | default property |
data. |
string | e.g. /api/v2/property/0a3f5088-0f97-32b8-e044-0003ba298018 |
data. |
string | e.g. Tybrindvej 10 |
data. |
string | e.g. Husby |
data. |
string | e.g. 5592 |
data. |
string | e.g. Ejby |
data. |
string | e.g. DK |
data. |
array<string> | Fields your plan does not include; each is null. Present only when something is hidden. |
data. |
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 |