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/searchScope: persons · Kvote: tæller i kvoten
Parametre
| Parameter | Type | Beskrivelse |
|---|---|---|
qpå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
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. |
array<object> | |
data. |
object | |
data. |
integer | fx 4004068725 |
data. |
string | standard person |
data. |
string | fx /api/v2/person/4004068725 |
data. |
string | fx Jesper Buch |
data. |
integer | fx 4 |
data. |
integer | fx 3 |
data. |
integer | Det samlede antal poster i resultatet. fx 1 |
data. |
integer | Den aktuelle side. fx 1 |
data. |
integer | Antal sider i alt. fx 1 |
data. |
string | |
data. |
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 |
|---|---|---|
itemi stien, påkrævet |
integer | |
beneficial_ |
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_ |
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
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. |
integer | fx 4000528644 |
data. |
string | standard person |
data. |
string | fx /person/4000528644 |
data. |
string | fx Mick Stjernelykke |
data. |
object | |
data. |
string | fx 0a3f5088-0f97-32b8-e044-0003ba298018 |
data. |
string | standard property |
data. |
string | fx /api/v2/property/0a3f5088-0f97-32b8-e044-0003ba298018 |
data. |
string | fx Tybrindvej 10 |
data. |
string | fx Husby |
data. |
string | fx 5592 |
data. |
string | fx Ejby |
data. |
string | fx DK |
data. |
array<string> | Felter, din licens ikke omfatter; hvert af dem er null. Findes kun, når noget er skjult. |
data. |
object | |
data. |
array<object> | |
data. |
object | |
data. |
integer | fx 36473606 |
data. |
string | standard company |
data. |
string | fx /api/v2/company/36473606 |
data. |
string | fx WEB CODERS ApS |
data. |
string | fx 33.34-49.99% |
data. |
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. |
object | |
data. |
integer | fx 36473606 |
data. |
string | standard company |
data. |
string | fx /api/v2/company/36473606 |
data. |
string | fx WEB CODERS ApS |
data. |
string | fx 33,33% |
data. |
array<object> | |
data. |
object | |
data. |
integer | fx 36473606 |
data. |
string | standard company |
data. |
string | fx /api/v2/company/36473606 |
data. |
string | fx WEB CODERS ApS |
data. |
string | |
data. |
object | |
data. |
array<object> | |
data. |
object | |
data. |
integer | fx 36473606 |
data. |
string | standard company |
data. |
string | fx /api/v2/company/36473606 |
data. |
string | fx WEB CODERS ApS |
data. |
string | |
data. |
array<object> | |
data. |
object | |
data. |
integer | fx 36473606 |
data. |
string | standard company |
data. |
string | fx /api/v2/company/36473606 |
data. |
string | fx WEB CODERS ApS |
data. |
string | |
data. |
array<object> | |
data. |
object | |
data. |
integer | fx 36473606 |
data. |
string | standard company |
data. |
string | fx /api/v2/company/36473606 |
data. |
string | fx WEB CODERS ApS |
data. |
string | |
data. |
array<object> | |
data. |
object | |
data. |
integer | fx 36473606 |
data. |
string | standard company |
data. |
string | fx /api/v2/company/36473606 |
data. |
string | fx WEB CODERS ApS |
data. |
string | |
data. |
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. |
object | |
data. |
string | fx 0a3f5088-0f97-32b8-e044-0003ba298018 |
data. |
string | standard property |
data. |
string | fx /api/v2/property/0a3f5088-0f97-32b8-e044-0003ba298018 |
data. |
string | fx Tybrindvej 10 |
data. |
string | fx Husby |
data. |
string | fx 5592 |
data. |
string | fx Ejby |
data. |
string | fx DK |
data. |
array<string> | Felter, din licens ikke omfatter; hvert af dem er null. Findes kun, når noget er skjult. |
data. |
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 |