Gå til indhold

Erhvervspersoner

Søg og hent erhvervspersoner med roller, ejerskab og ejendomme.

Metode Sti Beskrivelse
GET /person/search Søg erhvervsperson på navn
GET /person/{itemId} Hent erhvervsperson

Søg erhvervsperson på navn

GET /person/search

Scope: persons · Kvote: tæller i kvoten

Parametre

Parameter Type Beskrivelse
q
påkrævet
string Personens navn, 3 til 100 tegn.
page integer Sidenummer. En søgning har højst 10 sider: efter side 10 er items tom, og kun count gives. standard 1
limit integer Resultater pr. side. standard 10 · 1–10

Eksempel

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
}
}

Felter i svaret

Felt Type Beskrivelse
data object
data.items array<object>
data.items[].item object
data.items[].item.id integer fx 4004068725
data.items[].item.slug string standard person
data.items[].item.url string fx /api/v2/person/4004068725
data.items[].item.name string fx Jesper Buch
data.items[].company_count integer fx 4
data.items[].relation_count integer fx 3
data.count integer Det samlede antal poster i resultatet. fx 1
data.page integer Den aktuelle side. fx 1
data.pageCount integer Antal sider i alt. fx 1
data.nextPageUrl string
data.prevPageUrl string

Fejl

Status Betydning
400 Søgningen er tom
401 Access token mangler, er ugyldigt eller udløbet
403 Access tokenet har ikke det scope, endpointet kræver
429 Kvoten eller timegrænsen er nået. Retry-After angiver ventetiden i sekunder; når kvoten er brugt op, linker error.upgrade_url til, hvor API-niveauet opgraderes

Hent erhvervsperson

GET /person/{itemId}

Scope: persons · Kvote: tæller i kvoten

Parametre

Parameter Type Beskrivelse
itemId
i stien, påkrævet
integer
beneficial_purpose string Formålet med opslaget på reelle ejere, se /beneficial-owners/purposes. Kræves sammen med beneficial_accept=1 for at se reelle ejere.
beneficial_accept integer Send 1 for at bekræfte erklæringen for det valgte beneficial_purpose, se /beneficial-owners/purposes. Hvert opslag logges med sit formål.

Eksempel

Terminal window
curl "https://ownr.dk/api/v2/person/4004068725" \
-H "Authorization: Bearer ACCESS_TOKEN"
Vis eksempel på svar
{
"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": ""
}
]
}
}

Felter i svaret

Vis alle 78 felter
Felt Type Beskrivelse
data object
data.id integer fx 4000528644
data.slug string standard person
data.url string fx /person/4000528644
data.name string fx Mick Stjernelykke
data.address object
data.address.id string fx 0a3f5088-0f97-32b8-e044-0003ba298018
data.address.slug string standard property
data.address.url string fx /api/v2/property/0a3f5088-0f97-32b8-e044-0003ba298018
data.address.address_1 string fx Tybrindvej 10
data.address.address_2 string fx Husby
data.address.zip string fx 5592
data.address.city string fx Ejby
data.address.country string fx DK
data.address.restricted array<string> Felter, din licens ikke omfatter; hvert af dem er null. Findes kun, når noget er skjult.
data.owned_companies object
data.owned_companies.legal array<object>
data.owned_companies.legal[].item object
data.owned_companies.legal[].item.id integer fx 36473606
data.owned_companies.legal[].item.slug string standard company
data.owned_companies.legal[].item.url string fx /api/v2/company/36473606
data.owned_companies.legal[].item.name string fx WEB CODERS ApS
data.owned_companies.legal[].notes string fx 33.34-49.99%
data.owned_companies.beneficial array<object> Kræver beneficial_purpose og beneficial_accept=1. Uden dem, med et ugyldigt formål, eller når reelle ejere ikke er slået til for jeres konto, indeholder listen ét enkelt element med en besked: item.slug = beneficial_owners_purposes, item.url peger på /beneficial-owners/purposes, og årsagen står i notes, fx To see beneficial owners pass beneficial_purpose and beneficial_accept=1. Allowed purposes: /api/v2/beneficial-owners/purposes eller Beneficial owners are not enabled for your account..
data.owned_companies.beneficial[].item object
data.owned_companies.beneficial[].item.id integer fx 36473606
data.owned_companies.beneficial[].item.slug string standard company
data.owned_companies.beneficial[].item.url string fx /api/v2/company/36473606
data.owned_companies.beneficial[].item.name string fx WEB CODERS ApS
data.owned_companies.beneficial[].notes string fx 33,33%
data.owned_companies.ultimate array<object>
data.owned_companies.ultimate[].item object
data.owned_companies.ultimate[].item.id integer fx 36473606
data.owned_companies.ultimate[].item.slug string standard company
data.owned_companies.ultimate[].item.url string fx /api/v2/company/36473606
data.owned_companies.ultimate[].item.name string fx 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 fx 36473606
data.roles.director[].item.slug string standard company
data.roles.director[].item.url string fx /api/v2/company/36473606
data.roles.director[].item.name string fx WEB CODERS ApS
data.roles.director[].notes string
data.roles.representative array<object>
data.roles.representative[].item object
data.roles.representative[].item.id integer fx 36473606
data.roles.representative[].item.slug string standard company
data.roles.representative[].item.url string fx /api/v2/company/36473606
data.roles.representative[].item.name string fx 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 fx 36473606
data.roles.store_manager[].item.slug string standard company
data.roles.store_manager[].item.url string fx /api/v2/company/36473606
data.roles.store_manager[].item.name string fx 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 fx 36473606
data.roles.board_member[].item.slug string standard company
data.roles.board_member[].item.url string fx /api/v2/company/36473606
data.roles.board_member[].item.name string fx WEB CODERS ApS
data.roles.board_member[].notes string
data.properties array<object> Ejendomme, som personen har adkomst til. item.id/item.url/item.address_1/item.address_2 er null og nævnes i item.restricted, når licensen ikke er mindst Premium. Vist her i fuld form, som med Premium.
data.properties[].item object
data.properties[].item.id string fx 0a3f5088-0f97-32b8-e044-0003ba298018
data.properties[].item.slug string standard property
data.properties[].item.url string fx /api/v2/property/0a3f5088-0f97-32b8-e044-0003ba298018
data.properties[].item.address_1 string fx Tybrindvej 10
data.properties[].item.address_2 string fx Husby
data.properties[].item.zip string fx 5592
data.properties[].item.city string fx Ejby
data.properties[].item.country string fx DK
data.properties[].item.restricted array<string> Felter, din licens ikke omfatter; hvert af dem er null. Findes kun, når noget er skjult.
data.properties[].notes string

Fejl

Status Betydning
400 Ugyldigt id
401 Access token mangler, er ugyldigt eller udløbet
403 Access tokenet har ikke det scope, endpointet kræver
404 Posten findes ikke
429 Kvoten eller timegrænsen er nået. Retry-After angiver ventetiden i sekunder; når kvoten er brugt op, linker error.upgrade_url til, hvor API-niveauet opgraderes