Gå til indhold

Pipeline

Opret pipelines, tilføj og flyt leads, og se jeres leadkapacitet.

Metode Sti Beskrivelse
GET /pipelines Vis pipelines
POST /pipelines Opret pipeline
GET /pipelines/capacity Leadkapacitet
GET /pipelines/{pipelineId} Hent pipeline
DELETE /pipelines/{pipelineId} Slet pipeline
PATCH /pipelines/{pipelineId}/stages/{stageId} Omdøb et stadie
GET /pipelines/{pipelineId}/leads Leads i en pipeline
POST /pipelines/{pipelineId}/leads Tilføj leads
PATCH /pipelines/{pipelineId}/leads/{leadId} Flyt et lead
DELETE /pipelines/{pipelineId}/leads/{leadId} Fjern et lead

Vis pipelines

GET /pipelines

Scope: pipeline · Kvote: tæller ikke i kvoten

Parametre

Parameter Type Beskrivelse
page integer Sidenummer.
sort string created_at, updated_at, name · standard created_at
direction string asc, desc · standard desc

Eksempel

Terminal window
curl "https://ownr.dk/api/v2/pipelines" \
-H "Authorization: Bearer ACCESS_TOKEN"
{
"status": "success",
"data": {
"items": [
{
"id": 189,
"name": "Egne kunder Q4",
"entity_type": "company",
"lead_count": 0,
"stages": [
{
"id": 1231,
"name": "Nye leads",
"stage_key": "new",
"locked": true,
"lead_count": 0
}
],
"created_at": "2026-08-04T09:14:22+02:00",
"updated_at": "2026-01-31T12:00:00+01:00",
"url": "https://ownr.dk/pipelines/view/189"
}
],
"total": 4,
"count": 4,
"page": 1,
"pageCount": 1,
"nextPageUrl": null,
"prevPageUrl": null
}
}

Felter i svaret

Felt Type Beskrivelse
data object
data.items array<object>
data.items[].id integer fx 189
data.items[].name string fx Egne kunder Q4
data.items[].entity_type string company, person, property · fx company
data.items[].lead_count integer fx 0
data.items[].stages array<object>
data.items[].stages[].id integer Brug dette id til at pege på stadiet i POST/GET leads. fx 1231
data.items[].stages[].name string fx Nye leads
data.items[].stages[].stage_key string Kun udfyldt for de 8 systemstadier (new/contacted/follow_up/in_dialog/offer_sent/follow_up2/won/lost); null for egne stadier. Kun til orientering: peg altid på et stadie med dets id. fx new
data.items[].stages[].locked boolean fx true
data.items[].stages[].lead_count integer fx 0
data.items[].created_at string (date-time) fx 2026-08-04T09:14:22+02:00
data.items[].updated_at string (date-time) Den seneste aktivitet i pipelinen: et lead er tilføjet, flyttet til et andet stadie eller fjernet, eller selve pipelinen er ændret.
data.items[].url string fx https://ownr.dk/pipelines/view/189
data.total integer Det samme som count. fx 4
data.count integer Det samlede antal poster i resultatet. fx 4
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 Ugyldigt id
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

Opret pipeline

POST /pipelines

Scope: pipeline · Kvote: tæller ikke i kvoten

Opretter en pipeline. At oprette en pipeline bruger aldrig kapacitet, det gør kun leads, så dette kald kan ikke svare 402.

Krop (JSON)

Felt Type Beskrivelse
name
påkrævet
string 0–48 tegn · fx Egne kunder Q4
entity_type
påkrævet
string Fastlægges ved oprettelsen og kan ikke ændres bagefter. company, person, property · fx company
stages array<string> Valgfri. Navne på helt nye, egne stadier, der skal oprettes; ikke et udvalg fra standardsættet. Nye leads, Vundet og Tabt findes altid og kan ikke fjernes; det, der angives her, lægges ind mellem dem. Udelad feltet for at beholde standardsættet på 8 stadier.

Eksempel

Terminal window
curl -X POST "https://ownr.dk/api/v2/pipelines" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"Egne kunder Q4","entity_type":"company","stages":["Custom Stage 1","Custom Stage 2"]}'
{
"status": "success",
"data": {
"item": {
"id": 189,
"name": "Egne kunder Q4",
"entity_type": "company",
"lead_count": 0,
"stages": [
{
"id": 1231,
"name": "Nye leads",
"stage_key": "new",
"locked": true,
"lead_count": 0
}
],
"created_at": "2026-08-04T09:14:22+02:00",
"updated_at": "2026-01-31T12:00:00+01:00",
"url": "https://ownr.dk/pipelines/view/189"
}
}
}

Felter i svaret

Felt Type Beskrivelse
data object
data.item object
data.item.id integer fx 189
data.item.name string fx Egne kunder Q4
data.item.entity_type string company, person, property · fx company
data.item.lead_count integer fx 0
data.item.stages array<object>
data.item.stages[].id integer Brug dette id til at pege på stadiet i POST/GET leads. fx 1231
data.item.stages[].name string fx Nye leads
data.item.stages[].stage_key string Kun udfyldt for de 8 systemstadier (new/contacted/follow_up/in_dialog/offer_sent/follow_up2/won/lost); null for egne stadier. Kun til orientering: peg altid på et stadie med dets id. fx new
data.item.stages[].locked boolean fx true
data.item.stages[].lead_count integer fx 0
data.item.created_at string (date-time) fx 2026-08-04T09:14:22+02:00
data.item.updated_at string (date-time) Den seneste aktivitet i pipelinen: et lead er tilføjet, flyttet til et andet stadie eller fjernet, eller selve pipelinen er ændret.
data.item.url string fx https://ownr.dk/pipelines/view/189

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
409 Konflikt
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

Leadkapacitet

GET /pipelines/capacity

Scope: pipeline · Kvote: tæller ikke i kvoten

Kald dette før en stor import for at afpasse størrelsen. De samme tal står i 402-svaret, når en import afvises, så et forhåndstjek er en optimering, ikke et krav.

Eksempel

Terminal window
curl "https://ownr.dk/api/v2/pipelines/capacity" \
-H "Authorization: Bearer ACCESS_TOKEN"
{
"status": "success",
"data": {
"capacity": {
"included": 250,
"used": 53,
"limit": 250,
"available": 197,
"segment_leads": 202,
"tier": {
"limit": 250,
"price_month": 0,
"price_year": 0,
"free": true
}
}
}
}

Felter i svaret

Felt Type Beskrivelse
data object
data.capacity object Leadkapaciteten gælder hele virksomheden: alle pipelines trækker på den samme pulje. Leads, der kommer fra et segment, følger med segmentet og tælles aldrig med her.
data.capacity.included integer Gratis grundkapacitet, altid inkluderet. fx 250
data.capacity.used integer Leads, der tæller i kapaciteten, på tværs af alle pipelines. fx 53
data.capacity.limit integer Det aktuelle loft (det inkluderede eller det købte niveau) fx 250
data.capacity.available integer fx 197
data.capacity.segment_leads integer Følger med deres segment; tælles ikke. fx 202
data.capacity.tier object
data.capacity.tier.limit integer fx 250
data.capacity.tier.price_month number fx 0
data.capacity.tier.price_year number fx 0
data.capacity.tier.free boolean fx true

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

GET /pipelines/{pipelineId}

Scope: pipeline · Kvote: tæller ikke i kvoten

Parametre

Parameter Type Beskrivelse
pipelineId
i stien, påkrævet
integer

Eksempel

Terminal window
curl "https://ownr.dk/api/v2/pipelines/189" \
-H "Authorization: Bearer ACCESS_TOKEN"
{
"status": "success",
"data": {
"item": {
"id": 189,
"name": "Egne kunder Q4",
"entity_type": "company",
"lead_count": 0,
"stages": [
{
"id": 1231,
"name": "Nye leads",
"stage_key": "new",
"locked": true,
"lead_count": 0
}
],
"created_at": "2026-08-04T09:14:22+02:00",
"updated_at": "2026-01-31T12:00:00+01:00",
"url": "https://ownr.dk/pipelines/view/189"
}
}
}

Felter i svaret

Felt Type Beskrivelse
data object
data.item object
data.item.id integer fx 189
data.item.name string fx Egne kunder Q4
data.item.entity_type string company, person, property · fx company
data.item.lead_count integer fx 0
data.item.stages array<object>
data.item.stages[].id integer Brug dette id til at pege på stadiet i POST/GET leads. fx 1231
data.item.stages[].name string fx Nye leads
data.item.stages[].stage_key string Kun udfyldt for de 8 systemstadier (new/contacted/follow_up/in_dialog/offer_sent/follow_up2/won/lost); null for egne stadier. Kun til orientering: peg altid på et stadie med dets id. fx new
data.item.stages[].locked boolean fx true
data.item.stages[].lead_count integer fx 0
data.item.created_at string (date-time) fx 2026-08-04T09:14:22+02:00
data.item.updated_at string (date-time) Den seneste aktivitet i pipelinen: et lead er tilføjet, flyttet til et andet stadie eller fjernet, eller selve pipelinen er ændret.
data.item.url string fx https://ownr.dk/pipelines/view/189

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

Slet pipeline

DELETE /pipelines/{pipelineId}

Scope: pipeline · Kvote: tæller ikke i kvoten

At slette en pipeline frigiver den kapacitet, dens leads optog. Det gør arkivering ikke.

Parametre

Parameter Type Beskrivelse
pipelineId
i stien, påkrævet
integer

Eksempel

Terminal window
curl -X DELETE "https://ownr.dk/api/v2/pipelines/189" \
-H "Authorization: Bearer ACCESS_TOKEN"
{
"status": "success",
"data": {
"deleted": true,
"capacity": {
"included": 250,
"used": 53,
"limit": 250,
"available": 197,
"segment_leads": 202,
"tier": {
"limit": 250,
"price_month": 0,
"price_year": 0,
"free": true
}
}
}
}

Felter i svaret

Felt Type Beskrivelse
data object
data.deleted boolean fx true
data.capacity object Leadkapaciteten gælder hele virksomheden: alle pipelines trækker på den samme pulje. Leads, der kommer fra et segment, følger med segmentet og tælles aldrig med her.
data.capacity.included integer Gratis grundkapacitet, altid inkluderet. fx 250
data.capacity.used integer Leads, der tæller i kapaciteten, på tværs af alle pipelines. fx 53
data.capacity.limit integer Det aktuelle loft (det inkluderede eller det købte niveau) fx 250
data.capacity.available integer fx 197
data.capacity.segment_leads integer Følger med deres segment; tælles ikke. fx 202
data.capacity.tier object
data.capacity.tier.limit integer fx 250
data.capacity.tier.price_month number fx 0
data.capacity.tier.price_year number fx 0
data.capacity.tier.free boolean fx true

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

Omdøb et stadie

PATCH /pipelines/{pipelineId}/stages/{stageId}

Scope: pipeline · Kvote: tæller ikke i kvoten

Virker på både låste stadier (systemstadier) og egne stadier. De 3 faste stadier (Nye leads/Vundet/Tabt) kan omdøbes, men ikke fjernes eller flyttes.

Parametre

Parameter Type Beskrivelse
pipelineId
i stien, påkrævet
integer
stageId
i stien, påkrævet
integer

Krop (JSON)

Felt Type Beskrivelse
name
påkrævet
string 0–100 tegn · fx Kontaktet igen

Eksempel

Terminal window
curl -X PATCH "https://ownr.dk/api/v2/pipelines/189/stages/1231" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"Kontaktet igen"}'
{
"status": "success",
"data": {
"item": {
"id": 1231,
"name": "Kontaktet igen",
"stage_key": null,
"locked": false,
"lead_count": 0
}
}
}

Felter i svaret

Felt Type Beskrivelse
data object
data.item object
data.item.id integer fx 1231
data.item.name string fx Kontaktet igen
data.item.stage_key string
data.item.locked boolean fx false
data.item.lead_count integer fx 0

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

Leads i en pipeline

GET /pipelines/{pipelineId}/leads

Scope: pipeline · Kvote: tæller ikke i kvoten

Parametre

Parameter Type Beskrivelse
pipelineId
i stien, påkrævet
integer
stage integer Filtrér på stadiets id.
page integer Sidenummer.

Eksempel

Terminal window
curl "https://ownr.dk/api/v2/pipelines/189/leads" \
-H "Authorization: Bearer ACCESS_TOKEN"
{
"status": "success",
"data": {
"items": [
{
"id": 90311,
"cvr": 36732261,
"name": "SNT ApS",
"stage": 1231,
"source": "api",
"counts_against_capacity": true,
"created_at": "2026-08-04T09:20:41+02:00"
}
],
"total": 412,
"count": 412,
"page": 1,
"pageCount": 21,
"nextPageUrl": "https://ownr.dk/api/v2/pipelines/7/leads?page=2",
"prevPageUrl": null
}
}

Felter i svaret

Felt Type Beskrivelse
data object
data.items array<object> Sorteret efter, hvornår leadet blev tilføjet.
data.items[].id integer fx 90311
data.items[].cvr integer fx 36732261
data.items[].name string fx SNT ApS
data.items[].stage integer Stadiets id; svarer til Pipeline.stages[].id. fx 1231
data.items[].source string api, csv, manual, segment · fx api
data.items[].counts_against_capacity boolean false for leads, der kommer fra et segment. fx true
data.items[].created_at string (date-time) fx 2026-08-04T09:20:41+02:00
data.total integer Det samme som count. fx 412
data.count integer Det samlede antal poster i resultatet. fx 412
data.page integer Den aktuelle side. fx 1
data.pageCount integer Antal sider i alt. fx 21
data.nextPageUrl string fx https://ownr.dk/api/v2/pipelines/7/leads?page=2
data.prevPageUrl 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

Tilføj leads

POST /pipelines/{pipelineId}/leads

Scope: pipeline · Kvote: tæller ikke i kvoten

Tilføjer virksomheder med CVR-nummer. Alt eller intet som standard: er der ikke plads til hele partiet i virksomhedens kapacitet, importeres intet, og svaret er 402 med det præcise antal, der mangler. Send partial=true for i stedet at importere så mange, der er plads til. Dubletter, der allerede er i pipelinen, springes over og rapporteres; de behandles ikke som fejl.

Parametre

Parameter Type Beskrivelse
pipelineId
i stien, påkrævet
integer

Krop (JSON)

Felt Type Beskrivelse
cvr
påkrævet
array<integer> højst 10000 elementer
stage integer Id på det stadie, leads skal lande i. Standard er det første stadie.
partial boolean Når true: importér så mange, kapaciteten tillader, i stedet for at afvise partiet. standard false

Eksempel

Terminal window
curl -X POST "https://ownr.dk/api/v2/pipelines/189/leads" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"cvr":[36732261,24256790,31183146],"stage":0,"partial":false}'
{
"status": "success",
"data": {
"added": 409,
"skipped_duplicates": 3,
"invalid_cvr": [
12345678
],
"partial": false,
"capacity": {
"included": 250,
"used": 53,
"limit": 250,
"available": 197,
"segment_leads": 202,
"tier": {
"limit": 250,
"price_month": 0,
"price_year": 0,
"free": true
}
}
}
}

Felter i svaret

Felt Type Beskrivelse
data object
data.added integer fx 409
data.skipped_duplicates integer fx 3
data.invalid_cvr array<integer>
data.partial boolean fx false
data.capacity object Leadkapaciteten gælder hele virksomheden: alle pipelines trækker på den samme pulje. Leads, der kommer fra et segment, følger med segmentet og tælles aldrig med her.
data.capacity.included integer Gratis grundkapacitet, altid inkluderet. fx 250
data.capacity.used integer Leads, der tæller i kapaciteten, på tværs af alle pipelines. fx 53
data.capacity.limit integer Det aktuelle loft (det inkluderede eller det købte niveau) fx 250
data.capacity.available integer fx 197
data.capacity.segment_leads integer Følger med deres segment; tælles ikke. fx 202
data.capacity.tier object
data.capacity.tier.limit integer fx 250
data.capacity.tier.price_month number fx 0
data.capacity.tier.price_year number fx 0
data.capacity.tier.free boolean fx true

Fejl

Status Betydning
400 Ugyldigt id
401 Access token mangler, er ugyldigt eller udløbet
402 Ikke nok leadkapacitet
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

Flyt et lead

PATCH /pipelines/{pipelineId}/leads/{leadId}

Scope: pipeline · Kvote: tæller ikke i kvoten

Samme virkning som at trække kortet i webappen: flytningen logges, teammedlemmer, der følger målstadiet, får besked, og flyttes leadet til Vundet med ajour_auto_add slået til, lægges det i Ajour.

Parametre

Parameter Type Beskrivelse
pipelineId
i stien, påkrævet
integer
leadId
i stien, påkrævet
integer

Krop (JSON)

Felt Type Beskrivelse
stage
påkrævet
integer Id på målstadiet. fx 1297

Eksempel

Terminal window
curl -X PATCH "https://ownr.dk/api/v2/pipelines/189/leads/90311" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"stage":1297}'
{
"status": "success",
"data": {
"item": {
"id": 90311,
"cvr": 36732261,
"name": "SNT ApS",
"stage": 1231,
"source": "api",
"counts_against_capacity": true,
"created_at": "2026-08-04T09:20:41+02:00"
}
}
}

Felter i svaret

Felt Type Beskrivelse
data object
data.item object
data.item.id integer fx 90311
data.item.cvr integer fx 36732261
data.item.name string fx SNT ApS
data.item.stage integer Stadiets id; svarer til Pipeline.stages[].id. fx 1231
data.item.source string api, csv, manual, segment · fx api
data.item.counts_against_capacity boolean false for leads, der kommer fra et segment. fx true
data.item.created_at string (date-time) fx 2026-08-04T09:20:41+02:00

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

Fjern et lead

DELETE /pipelines/{pipelineId}/leads/{leadId}

Scope: pipeline · Kvote: tæller ikke i kvoten

At fjerne et lead frigiver dets kapacitet med det samme.

Parametre

Parameter Type Beskrivelse
pipelineId
i stien, påkrævet
integer
leadId
i stien, påkrævet
integer

Eksempel

Terminal window
curl -X DELETE "https://ownr.dk/api/v2/pipelines/189/leads/90311" \
-H "Authorization: Bearer ACCESS_TOKEN"
{
"status": "success",
"data": {
"deleted": true,
"capacity": {
"included": 250,
"used": 53,
"limit": 250,
"available": 197,
"segment_leads": 202,
"tier": {
"limit": 250,
"price_month": 0,
"price_year": 0,
"free": true
}
}
}
}

Felter i svaret

Felt Type Beskrivelse
data object
data.deleted boolean fx true
data.capacity object Leadkapaciteten gælder hele virksomheden: alle pipelines trækker på den samme pulje. Leads, der kommer fra et segment, følger med segmentet og tælles aldrig med her.
data.capacity.included integer Gratis grundkapacitet, altid inkluderet. fx 250
data.capacity.used integer Leads, der tæller i kapaciteten, på tværs af alle pipelines. fx 53
data.capacity.limit integer Det aktuelle loft (det inkluderede eller det købte niveau) fx 250
data.capacity.available integer fx 197
data.capacity.segment_leads integer Følger med deres segment; tælles ikke. fx 202
data.capacity.tier object
data.capacity.tier.limit integer fx 250
data.capacity.tier.price_month number fx 0
data.capacity.tier.price_year number fx 0
data.capacity.tier.free boolean fx true

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