Skip to content

Careers Orbit delivery API

Jobs, filters, the career site, applications, the talent pool and the candidate portal, for your own website or app.

The delivery API gives your website or app everything your hosted career pages show. Every call needs a public key (careers_pk_) as Authorization: Bearer, X-Api-Key or ?key=. Answers are JSON in data; errors are error with a code and a message candidates can read.

Any website may call it from a browser unless you list allowed websites in Careers Orbit; calls from servers are always allowed. Reads are cacheable for 60 seconds.

Each network may make 120 requests a minute with one key. Applications and the talent pool allow 6 at once and then 2 a minute, view counts 30 a minute, sign-in codes 5 at once and then 1 a minute, sign-in tries 10 and then 5 a minute, and the rest of the portal 60 and then 30 a minute. Going over answers 429 rate_limited; no rate-limit headers are sent, so wait a minute and try again.

Read the guideOpenAPI 3.1 document

Try it settings

https://api.bifrostorbit.com/careers/v1

Every call needs a public key (careers_pk_) from API keys in Careers Orbit.

Try it sends each request straight from your browser to the API. The key stays in this page's memory: it is never saved, never sent to docs.bifrostorbit.com and gone when you leave or reload the page. Only reads are run; anything that changes data is described and never sent.

JobsLive jobs and the filters for them.

List live jobs

GET/jobsKey required

Live jobs, newest first, a page at a time: page and perPage choose the page, and meta.total says how many match. A key that reads internal-only jobs sees those too. Cacheable for 60 seconds.

Parameters

  • localestringquery

    A language, such as de. lang works too. Text missing in it comes in your main language, field by field.

  • departmentstringquery

    A department id from filters.

  • locationstringquery

    A location id from filters.

  • remotestringquery

    onsite, hybrid or remote.

    One of onsite, hybrid, remote.
  • typestringquery

    An employment type.

    One of fullTime, partTime, contract, temporary, internship, apprenticeship, workingStudent.
  • qstringquery

    Words in the title, summary, department or location.

  • pageintegerquery

    1 or more.

    Default 1. At least 1.
  • perPageintegerquery

    50 unless you say, up to 100. Larger values are capped at 100.

    Default 50. At least 1. At most 100.

Responses

  • 200OKA page of jobs.
    • dataJob[]

      Fields of data
      • idstring

      • slugstring

      • urlstring

        On your website if you set job addresses, otherwise on your hosted pages.

      • titlestring

      • summarystring

      • departmentobject or null

        Fields of department
        • idstring

        • namestring

      • locationsLocation[]

        Fields of Location

      • employmentTypestring

        One of fullTime, partTime, contract, temporary, internship, apprenticeship, workingStudent.
      • employmentTypeLabelstring

      • remotestring

        One of onsite, hybrid, remote.
      • remoteLabelstring

      • salarySalary or any or null

        Only when you chose to show it.

        Fields of salary

        One of:

        Salary

        • mininteger or null

        • maxinteger or null

        • currencystring

        • periodstring

          One of year, month, hour.
        • textstring

          Ready to show, such as 42.000 NOK – 48.000 NOK pro Monat.

        any or null

      • publishedAtstring

      • closesAtstring or null

      • internalboolean

        Internal-only. Only keys that read internal jobs see these.

    • metaobject

      Fields of meta
      • localestring

        The language used.

      • totalinteger

        Jobs that match, across all pages.

      • pageinteger

        This page.

      • perPageinteger

        Jobs a page.

  • 401UnauthorisedNo key, or a key that is wrong, revoked or expired.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 402Payment requiredCareers Orbit is paused because the trial or plan ended.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 403ForbiddenA browser call from a website not on your allowed list.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 429Too many requestsMore than about 120 requests a minute from one network with one key.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 500Server errorSomething failed on our side. Try again in a moment.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

Shell
curl 'https://api.bifrostorbit.com/careers/v1/jobs' \  -H 'Authorization: Bearer careers_pk_…'

Try it

Paste a public key above first.

Example answer

200 OKJSON
{  "data": [    {      "id": "6651a0c2b9e4c1d2e3f40b02",      "slug": "shop-assistant-oslo",      "url": "https://northwilds.com/careers/shop-assistant-oslo",      "title": "Shop assistant, Oslo",      "summary": "Help people choose the right boots, tents and layers in our Oslo shop.",      "department": {        "id": "6651a0c2b9e4c1d2e3f40a12",        "name": "Shop"      },      "locations": [        {          "id": "6651a0c2b9e4c1d2e3f40a22",          "name": "Oslo shop",          "street": "Markveien 35",          "postalCode": "0554",          "city": "Oslo",          "region": "Oslo",          "country": "NO",          "remote": "onsite"        }      ],      "employmentType": "partTime",      "employmentTypeLabel": "Part time",      "remote": "onsite",      "remoteLabel": "On site",      "salary": null,      "publishedAt": "2026-10-28T08:00:00.000Z",      "closesAt": null,      "internal": false    },    {      "id": "6651a0c2b9e4c1d2e3f40b01",      "slug": "trip-guide-lofoten",      "url": "https://northwilds.com/careers/trip-guide-lofoten",      "title": "Trip guide, Lofoten",      "summary": "Lead small groups on sea kayaking and ridge walks in Lofoten, from May to September.",      "department": {        "id": "6651a0c2b9e4c1d2e3f40a11",        "name": "Trips"      },      "locations": [        {          "id": "6651a0c2b9e4c1d2e3f40a21",          "name": "Lofoten base",          "street": "Torget 4",          "postalCode": "8300",          "city": "Svolvær",          "region": "Nordland",          "country": "NO",          "remote": "onsite"        }      ],      "employmentType": "temporary",      "employmentTypeLabel": "Temporary",      "remote": "onsite",      "remoteLabel": "On site",      "salary": {        "min": 42000,        "max": 48000,        "currency": "NOK",        "period": "month",        "text": "NOK 42,000 – NOK 48,000 a month"      },      "publishedAt": "2026-10-20T08:00:00.000Z",      "closesAt": "2027-01-31T23:00:00.000Z",      "internal": false    }  ],  "meta": {    "locale": "en",    "total": 2,    "page": 1,    "perPage": 50  }}

Get a job

GET/jobs/{slug}Key required

One live job with its description, application form, privacy notice and JobPosting data. A closed, scheduled or unpublished job is 404.

Parameters

  • slugstringpath, required

    The job's address or id.

  • localestringquery

    A language, such as de. lang works too. Text missing in it comes in your main language, field by field.

Responses

  • 200OKThe job.
    • dataJobDetail

      Fields of data
      • idstring

      • slugstring

      • urlstring

        On your website if you set job addresses, otherwise on your hosted pages.

      • titlestring

      • summarystring

      • departmentobject or null

        Fields of department
        • idstring

        • namestring

      • locationsLocation[]

        Fields of Location

      • employmentTypestring

        One of fullTime, partTime, contract, temporary, internship, apprenticeship, workingStudent.
      • employmentTypeLabelstring

      • remotestring

        One of onsite, hybrid, remote.
      • remoteLabelstring

      • salarySalary or any or null

        Only when you chose to show it.

        Fields of salary

        One of:

        Salary

        • mininteger or null

        • maxinteger or null

        • currencystring

        • periodstring

          One of year, month, hour.
        • textstring

          Ready to show, such as 42.000 NOK – 48.000 NOK pro Monat.

        any or null

      • publishedAtstring

      • closesAtstring or null

      • internalboolean

        Internal-only. Only keys that read internal jobs see these.

      • localestring

        The language used.

      • localesstring[]

        Languages the job is in.

      • fallbackstring[]

        Fields that came in the main language.

      • descriptionstring

        Cleaned HTML.

      • seoobject

        Fields of seo
        • titlestring

        • descriptionstring

      • cmsEntryIdstring or null

        The CMS Orbit entry for the job page, when linked.

      • formobject

        What to ask, without screening rules.

        Fields of form
        • fieldsmap of string

          Standard fields: phone, cv, coverLetter, linkedin, location, salaryExpectation, startDate.

        • questionsQuestion[]

          Fields of Question

      • privacyobject

        Fields of privacy
        • versioninteger

          Send as privacyVersion.

        • textstring

      • jobPostingmap of any

        schema.org JobPosting, for a ld+json script for Google for Jobs.

  • 401UnauthorisedNo key, or a key that is wrong, revoked or expired.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 402Payment requiredCareers Orbit is paused because the trial or plan ended.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 403ForbiddenA browser call from a website not on your allowed list.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 404Not foundNo such job, or it isn't live.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 429Too many requestsMore than about 120 requests a minute from one network with one key.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 500Server errorSomething failed on our side. Try again in a moment.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

Shell
curl 'https://api.bifrostorbit.com/careers/v1/jobs/mountain-guide-lofoten' \  -H 'Authorization: Bearer careers_pk_…'

Try it

Paste a public key above first.

Example answer

200 OKJSON
{  "data": {    "id": "6651a0c2b9e4c1d2e3f40b01",    "slug": "trip-guide-lofoten",    "url": "https://northwilds.com/careers/trip-guide-lofoten",    "title": "Trip guide, Lofoten",    "summary": "Lead small groups on sea kayaking and ridge walks in Lofoten, from May to September.",    "department": {      "id": "6651a0c2b9e4c1d2e3f40a11",      "name": "Trips"    },    "locations": [      {        "id": "6651a0c2b9e4c1d2e3f40a21",        "name": "Lofoten base",        "street": "Torget 4",        "postalCode": "8300",        "city": "Svolvær",        "region": "Nordland",        "country": "NO",        "remote": "onsite"      }    ],    "employmentType": "temporary",    "employmentTypeLabel": "Temporary",    "remote": "onsite",    "remoteLabel": "On site",    "salary": {      "min": 42000,      "max": 48000,      "currency": "NOK",      "period": "month",      "text": "NOK 42,000 – NOK 48,000 a month"    },    "publishedAt": "2026-10-20T08:00:00.000Z",    "closesAt": "2027-01-31T23:00:00.000Z",    "internal": false,    "locale": "en",    "locales": [      "en",      "nb"    ],    "fallback": [],    "description": "<p>You will guide groups of up to eight on our Lofoten sea kayaking and ridge walk trips.</p><ul><li>Kayak guide or mountain leader certificate</li><li>First aid at work</li></ul>",    "seo": {      "title": "Trip guide, Lofoten | Northwilds careers",      "description": "Guide sea kayaking and ridge walks in Lofoten for Northwilds this summer."    },    "cmsEntryId": null,    "form": {      "fields": {        "phone": "required",        "cv": "required",        "coverLetter": "optional",        "linkedin": "off",        "location": "optional",        "salaryExpectation": "off",        "startDate": "required"      },      "questions": [        {          "id": "certificate",          "kind": "choice",          "label": "Which guiding certificate do you hold?",          "help": "",          "required": true,          "options": [            {              "id": "kayak",              "label": "Sea kayak guide"            },            {              "id": "mountain",              "label": "Mountain leader"            },            {              "id": "both",              "label": "Both"            }          ]        },        {          "id": "season",          "kind": "yesNo",          "label": "Can you work the whole season, May to September?",          "help": "",          "required": true,          "options": []        }      ]    },    "privacy": {      "version": 3,      "text": "Northwilds keeps your application for six months after the job is filled, then deletes it. Ask hr@northwilds.com about your data at any time."    },    "jobPosting": {      "@context": "https://schema.org/",      "@type": "JobPosting",      "title": "Trip guide, Lofoten",      "datePosted": "2026-10-20",      "employmentType": "TEMPORARY",      "hiringOrganization": {        "@type": "Organization",        "name": "Northwilds",        "sameAs": "https://northwilds.com"      },      "directApply": true,      "url": "https://northwilds.com/careers/trip-guide-lofoten"    }  }}

Get the filters

GET/filtersKey required

Departments, locations, job types and workplaces that have live jobs, with counts.

Parameters

  • localestringquery

    A language, such as de. lang works too. Text missing in it comes in your main language, field by field.

Responses

  • 200OKThe filters.
    • dataFilters

      Fields of data
      • departmentsobject[]

        Fields of departments
        • valuestring

        • labelstring

        • countinteger

          Live jobs with it.

      • locationsobject[]

        Fields of locations
        • valuestring

        • labelstring

        • countinteger

        • citystring

        • countrystring

      • employmentTypesobject[]

        Fields of employmentTypes
        • valuestring

        • labelstring

        • countinteger

          Live jobs with it.

      • remoteobject[]

        Fields of remote
        • valuestring

        • labelstring

        • countinteger

          Live jobs with it.

  • 401UnauthorisedNo key, or a key that is wrong, revoked or expired.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 402Payment requiredCareers Orbit is paused because the trial or plan ended.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 403ForbiddenA browser call from a website not on your allowed list.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 429Too many requestsMore than about 120 requests a minute from one network with one key.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 500Server errorSomething failed on our side. Try again in a moment.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

Shell
curl 'https://api.bifrostorbit.com/careers/v1/filters' \  -H 'Authorization: Bearer careers_pk_…'

Try it

Paste a public key above first.

Example answer

200 OKJSON
{  "data": {    "departments": [      {        "value": "6651a0c2b9e4c1d2e3f40a11",        "label": "Trips",        "count": 1      },      {        "value": "6651a0c2b9e4c1d2e3f40a12",        "label": "Shop",        "count": 1      }    ],    "locations": [      {        "value": "6651a0c2b9e4c1d2e3f40a21",        "label": "Svolvær",        "count": 1,        "city": "Svolvær",        "country": "NO"      },      {        "value": "6651a0c2b9e4c1d2e3f40a22",        "label": "Oslo",        "count": 1,        "city": "Oslo",        "country": "NO"      }    ],    "employmentTypes": [      {        "value": "partTime",        "label": "Part time",        "count": 1      },      {        "value": "temporary",        "label": "Temporary",        "count": 1      }    ],    "remote": [      {        "value": "onsite",        "label": "On site",        "count": 2      }    ]  }}

Career siteThe site's details and sitemap.

Get the career site

GET/siteKey required

Name, introduction, logo, colours, languages, contact email, hosted address, the current privacy notice, the Insights Orbit site key and the texting channels.

Parameters

  • localestringquery

    A language, such as de. lang works too. Text missing in it comes in your main language, field by field.

Responses

  • 200OKThe site.
    • dataSite

      Fields of data
      • namestring

      • slugstring

      • introstring

      • logoUrlstring or null

      • coloursobject

        Fields of colours
        • brandstring or null

        • accentstring or null

      • localestring

      • languagesstring[]

      • defaultLanguagestring

      • contactEmailstring or null

      • websiteUrlstring or null

      • hostedUrlstring

      • privacyobject

        The notice candidates agree to.

        Fields of privacy
        • versioninteger

        • textstring

      • insightsobject or null

        Fields of insights
        • sitestring

          The Insights Orbit site key.

      • textingobject or null

        Fields of texting
        • smsboolean

        • whatsappboolean

  • 401UnauthorisedNo key, or a key that is wrong, revoked or expired.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 402Payment requiredCareers Orbit is paused because the trial or plan ended.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 403ForbiddenA browser call from a website not on your allowed list.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 429Too many requestsMore than about 120 requests a minute from one network with one key.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 500Server errorSomething failed on our side. Try again in a moment.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

Shell
curl 'https://api.bifrostorbit.com/careers/v1/site' \  -H 'Authorization: Bearer careers_pk_…'

Try it

Paste a public key above first.

Example answer

200 OKJSON
{  "data": {    "name": "Northwilds",    "slug": "northwilds",    "intro": "Guide trips in the far north, or help people gear up for them in our Oslo shop.",    "logoUrl": "https://media.northwilds.com/logo.svg",    "colours": {      "brand": "#1F3A2E",      "accent": "#E07A2E"    },    "locale": "en",    "languages": [      "en",      "nb"    ],    "defaultLanguage": "en",    "contactEmail": "hr@northwilds.com",    "websiteUrl": "https://northwilds.com",    "hostedUrl": "https://app.bifrostorbit.com/careers/jobs/northwilds",    "privacy": {      "version": 3,      "text": "Northwilds keeps your application for six months after the job is filled, then deletes it. Ask hr@northwilds.com about your data at any time."    },    "insights": null,    "texting": {      "sms": true,      "whatsapp": false    }  }}

Get the sitemap

GET/sitemapKey required

Every live job with its address in each language.

Responses

  • 200OKThe jobs.
    • dataobject[]

      Fields of data
      • urlstring

      • slugstring

      • updatedAtstring

      • alternatesmap of string

        Addresses by language.

  • 401UnauthorisedNo key, or a key that is wrong, revoked or expired.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 402Payment requiredCareers Orbit is paused because the trial or plan ended.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 403ForbiddenA browser call from a website not on your allowed list.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 429Too many requestsMore than about 120 requests a minute from one network with one key.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 500Server errorSomething failed on our side. Try again in a moment.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

Shell
curl 'https://api.bifrostorbit.com/careers/v1/sitemap' \  -H 'Authorization: Bearer careers_pk_…'

Try it

Paste a public key above first.

Example answer

200 OKJSON
{  "data": [    {      "url": "https://northwilds.com/careers/trip-guide-lofoten",      "slug": "trip-guide-lofoten",      "updatedAt": "2026-11-02T09:30:00.000Z",      "alternates": {        "en": "https://northwilds.com/careers/trip-guide-lofoten",        "nb": "https://northwilds.com/nb/careers/trip-guide-lofoten"      }    }  ]}

ApplicationsApplications, the talent pool and view counts.

Send an application

POST/jobs/{slug}/applicationsKey required

multipart/form-data with data (the JSON below), cv (a PDF or Word file up to 10 MB) and file:<questionId> for each file question. Without files a JSON body works too. A second application to the same job from the same email updates the first. Each network may send 6 at once, then 2 a minute.

Parameters

  • slugstringpath, required

    The job's address or id.

Request body

  • firstNamestringrequired

    Up to 80 characters.
  • lastNamestringrequired

    Up to 80 characters.
  • emailstringrequired

    Up to 200 characters.
  • phonestring or nulloptional

    Up to 40 characters.
  • coverLetterstring or nulloptional

    Up to 10000 characters.
  • linkedinstring or nulloptional

    Up to 300 characters.
  • locationstring or nulloptional

    Up to 120 characters.
  • salaryExpectationstring or nulloptional

    Up to 120 characters.
  • startDatestring or nulloptional

    Up to 40 characters.
  • answersmap of anyoptional

    By question id. Choice answers are option ids; yes or no answers are yes or no.

  • privacyVersionintegerrequired

    The job's privacy.version. If the notice changed since, the call fails with a request to reload.

  • privacyAcceptedtruerequired

  • talentPoolbooleanoptional

  • textingstring[]optional

  • localestringoptional

  • sourcestringoptional

    Such as northwilds.com.

    Up to 60 characters.
  • utmobjectoptional

    Fields of utm
    • sourcestring or nulloptional

    • mediumstring or nulloptional

    • campaignstring or nulloptional

  • referrerstring or nulloptional

  • referralstring or nulloptional

    The ref from a colleague's referral link.

Responses

  • 200OKIt updated an earlier application.
    • dataobject

      Fields of data
      • applicationIdstring

      • updatedboolean

  • 201CreatedA new application.
    • dataobject

      Fields of data
      • applicationIdstring

      • updatedboolean

  • 400Bad requestA field or answer is wrong, a file is too large or not a PDF or Word file, or the privacy notice changed.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 401UnauthorisedNo key, or a key that is wrong, revoked or expired.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 402Payment requiredCareers Orbit is paused because the trial or plan ended.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 403ForbiddenA browser call from a website not on your allowed list, or files over 40 MB in all.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 404Not foundNo such job, or it isn't live.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 422UnprocessableA required field is missing or has the wrong type, with issues.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 429Too many requestsMore than 6 applications at once, or 2 a minute after that, from one network.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 500Server errorSomething failed on our side. Try again in a moment.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

Shell
curl -X POST 'https://api.bifrostorbit.com/careers/v1/jobs/mountain-guide-lofoten/applications' \  -H 'Authorization: Bearer careers_pk_…' \  -H 'Content-Type: application/json' \  -d '{"firstName":"Kari","lastName":"Nordmann","email":"kari.nordmann@northwilds.com","phone":"+47 912 34 567","startDate":"2027-05-01","answers":{"certificate":"kayak","season":"yes"},"privacyVersion":3,"privacyAccepted":true,"source":"northwilds.com"}'

Try it

It creates a real application and emails the candidate.

Example answer

200 OKJSON
{  "data": {    "applicationId": "6651a0c2b9e4c1d2e3f40c01",    "updated": true  }}

Count a view or a start

POST/jobs/{slug}/trackKey required

kind view when a job page shows, start when someone starts the form. Stores no cookies and nothing about the person, and ignores bots. An unknown job is quietly not counted. 30 a minute per network.

Parameters

  • slugstringpath, required

    The job's address or id.

Request body

  • kindstringrequired

    One of view, start.
  • sourcestringoptional

  • utmSourcestringoptional

Responses

  • 204No contentCounted.
  • 401UnauthorisedNo key, or a key that is wrong, revoked or expired.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 402Payment requiredCareers Orbit is paused because the trial or plan ended.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 403ForbiddenA browser call from a website not on your allowed list.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 422Unprocessablekind is missing or unknown.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 429Too many requestsMore than 30 a minute from one network.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 500Server errorSomething failed on our side. Try again in a moment.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

Shell
curl -X POST 'https://api.bifrostorbit.com/careers/v1/jobs/mountain-guide-lofoten/track' \  -H 'Authorization: Bearer careers_pk_…' \  -H 'Content-Type: application/json' \  -d '{"kind":"view","source":"northwilds.com"}'

Try it

It counts towards your real reports.

Join the talent pool

POST/talent-poolKey required

Keeps someone's details for future jobs, with job alerts if they want them. Each network may send 6 at once, then 2 a minute.

Request body

  • firstNamestringrequired

    Up to 80 characters.
  • lastNamestringoptional

    Up to 80 characters.
  • emailstringrequired

  • privacyVersionintegerrequired

  • privacyAcceptedtruerequired

  • localestringoptional

  • jobAlertsbooleanoptional

    Email when a new job opens.

  • departmentIdsstring[]optional

    Only jobs in these departments.

    Up to 30 items.

Responses

  • 201CreatedJoined.
    • dataobject

      Fields of data
      • joinedtrue

  • 400Bad requestA field is wrong, or the privacy notice changed.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 401UnauthorisedNo key, or a key that is wrong, revoked or expired.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 402Payment requiredCareers Orbit is paused because the trial or plan ended.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 403ForbiddenA browser call from a website not on your allowed list.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 422UnprocessableA required field is missing or has the wrong type, with issues.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 429Too many requestsMore than 6 at once, or 2 a minute after that, from one network.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 500Server errorSomething failed on our side. Try again in a moment.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

Shell
curl -X POST 'https://api.bifrostorbit.com/careers/v1/talent-pool' \  -H 'Authorization: Bearer careers_pk_…' \  -H 'Content-Type: application/json' \  -d '{"firstName":"Ingrid","lastName":"Berg","email":"ingrid.berg@northwilds.com","privacyVersion":3,"privacyAccepted":true,"jobAlerts":true,"departmentIds":["6651a0c2b9e4c1d2e3f40a11"]}'

Try it

It saves a real person's details.

Example answer

201 CreatedJSON
{  "data": {    "joined": true  }}

Candidate portalCandidates sign in with an email code and see their applications and offers.

Send a sign-in code

POST/portal/codeKey required

Emails a six-digit code if the address has applied. Always answers { sent: true }. A code lasts ten minutes and allows five tries; each network may ask for 5 at once, then 1 a minute. Never cached, and it works while Careers Orbit is paused.

Request body

  • emailstringrequired

  • localestringoptional

Responses

  • 200OKSent, or not, without saying which.
    • dataobject

      Fields of data
      • senttrue

  • 400Bad requestNot an email address.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 401UnauthorisedNo key, or a key that is wrong, revoked or expired.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 403ForbiddenA browser call from a website not on your allowed list.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 422Unprocessableemail is missing.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 429Too many requestsMore than 5 codes at once, or 1 a minute after that, from one network.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 500Server errorSomething failed on our side. Try again in a moment.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

Shell
curl -X POST 'https://api.bifrostorbit.com/careers/v1/portal/code' \  -H 'Authorization: Bearer careers_pk_…' \  -H 'Content-Type: application/json' \  -d '{"email":"kari.nordmann@northwilds.com","locale":"en"}'

Try it

It emails a real candidate.

Example answer

200 OKJSON
{  "data": {    "sent": true  }}

Sign in

POST/portal/sessionKey required

Swaps the email and code for a session token that lasts two hours. Send it in X-Careers-Session. Each network may try 10 at once, then 5 a minute. Never cached, and it works while Careers Orbit is paused.

Request body

  • emailstringrequired

  • codestringrequired

Responses

  • 200OKSigned in.
    • dataobject

      Fields of data
      • tokenstring

      • expiresIninteger

        Seconds.

  • 400Bad requestA wrong or expired code.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 401UnauthorisedNo key, or a key that is wrong, revoked or expired.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 403ForbiddenA browser call from a website not on your allowed list.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 422Unprocessableemail or code is missing.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 429Too many requestsMore than 10 tries at once, or 5 a minute after that, from one network.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 500Server errorSomething failed on our side. Try again in a moment.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

Shell
curl -X POST 'https://api.bifrostorbit.com/careers/v1/portal/session' \  -H 'Authorization: Bearer careers_pk_…' \  -H 'Content-Type: application/json' \  -d '{"email":"kari.nordmann@northwilds.com","code":"482913"}'

Try it

It needs a code from a real inbox.

Example answer

200 OKJSON
{  "data": {    "token": "…",    "expiresIn": 7200  }}

Sign out

DELETE/portal/sessionKey required

Answers signedOut. The token itself runs out after two hours, so forget it on your side. Never cached, and it works while Careers Orbit is paused.

Responses

  • 200OKSigned out.
    • dataobject

      Fields of data
      • signedOuttrue

  • 401UnauthorisedNo key, or a key that is wrong, revoked or expired.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 403ForbiddenA browser call from a website not on your allowed list.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 500Server errorSomething failed on our side. Try again in a moment.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

Shell
curl -X DELETE 'https://api.bifrostorbit.com/careers/v1/portal/session' \  -H 'Authorization: Bearer careers_pk_…'

Try it

It needs a candidate signed in to the portal.

Example answer

200 OKJSON
{  "data": {    "signedOut": true  }}

The candidate's portal

GET/portal/meKey required

Applications, offers, talent pool and requests, or { data: null } when signed out. Never cached, and it works while Careers Orbit is paused.

Parameters

  • X-Careers-Sessionstringheader, required

    The candidate's portal session, from the session endpoint.

Responses

  • 200OKThe whole portal again, as GET /portal/me answers.
    • dataPortal

      The candidate's applications, offers, talent pool and requests, or null when signed out.

  • 401UnauthorisedNo key, or a wrong key.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 403ForbiddenA browser call from a website not on your allowed list.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 429Too many requestsMore than 30 portal requests a minute from one network, after a burst of 60.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 500Server errorSomething failed on our side. Try again in a moment.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

Shell
curl 'https://api.bifrostorbit.com/careers/v1/portal/me' \  -H 'Authorization: Bearer careers_pk_…' \  -H 'X-Careers-Session: …'

Try it

It needs a candidate signed in to the portal.

Example answer

200 OKJSON
{  "data": {    "candidate": {      "firstName": "Kari",      "lastName": "Nordmann",      "email": "kari.nordmann@northwilds.com",      "locale": "en"    },    "site": {      "name": "Northwilds",      "privacyVersion": 3,      "contactEmail": "hr@northwilds.com"    },    "applications": [      {        "id": "6651a0c2b9e4c1d2e3f40c01",        "jobTitle": "Trip guide, Lofoten",        "jobUrl": "https://northwilds.com/careers/trip-guide-lofoten",        "stage": "Interviews",        "status": "active",        "appliedAt": "2026-10-24T18:12:00.000Z",        "updatedAt": "2026-11-02T09:30:00.000Z",        "canWithdraw": true,        "canUpload": true,        "files": [          {            "id": "6651a0c2b9e4c1d2e3f40d01",            "name": "kari-nordmann-cv.pdf",            "size": 184220,            "kind": "cv",            "createdAt": "2026-10-24T18:12:00.000Z"          }        ]      }    ],    "offers": [],    "texting": [      "sms"    ],    "talentPool": {      "member": true,      "until": "2028-10-24T18:12:00.000Z"    },    "requests": [],    "erasureAt": null  }}

Download the candidate's data

GET/portal/exportKey required

A JSON download, with links to their files that work for 15 minutes. Never cached, and it works while Careers Orbit is paused.

Parameters

  • X-Careers-Sessionstringheader, required

    The candidate's portal session, from the session endpoint.

Responses

  • 200OKThe data, as a download.
  • 401UnauthorisedNo key or a wrong key, or no portal session or one that has expired.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 403ForbiddenA browser call from a website not on your allowed list.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 429Too many requestsMore than 30 portal requests a minute from one network, after a burst of 60.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 500Server errorSomething failed on our side. Try again in a moment.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

Shell
curl 'https://api.bifrostorbit.com/careers/v1/portal/export' \  -H 'Authorization: Bearer careers_pk_…' \  -H 'X-Careers-Session: …'

Try it

It needs a candidate signed in to the portal.

Example answer

200 OKJSON
{  "exportedAt": "2026-11-02T09:30:00.000Z",  "organisation": "Northwilds",  "contact": "hr@northwilds.com",  "you": {    "firstName": "Kari",    "lastName": "Nordmann",    "email": "kari.nordmann@northwilds.com"  },  "applications": [    {      "job": "Trip guide, Lofoten",      "status": "active"    }  ]}

Withdraw an application

POST/portal/applications/{id}/withdrawKey required

Withdraws an open application. reason is optional, up to 500 characters. Never cached, and it works while Careers Orbit is paused.

Parameters

  • idstringpath, required

    The application's or offer's id.

  • X-Careers-Sessionstringheader, required

    The candidate's portal session, from the session endpoint.

Request body

  • reasonstring or nulloptional

    Up to 500 characters.

Responses

  • 200OKThe whole portal again, as GET /portal/me answers.
    • dataPortal

      The candidate's applications, offers, talent pool and requests, or null when signed out.

  • 400Bad requestThe application isn't open any more.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 401UnauthorisedNo key or a wrong key, or no portal session or one that has expired.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 403ForbiddenA browser call from a website not on your allowed list.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 404Not foundNo application with that id for this candidate.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 422Unprocessablereason is too long.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 429Too many requestsMore than 30 portal requests a minute from one network, after a burst of 60.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 500Server errorSomething failed on our side. Try again in a moment.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

Shell
curl -X POST 'https://api.bifrostorbit.com/careers/v1/portal/applications/6651a0c2b9e4c1d2e3f40c01/withdraw' \  -H 'Authorization: Bearer careers_pk_…' \  -H 'X-Careers-Session: …' \  -H 'Content-Type: application/json' \  -d '{"reason":"I have taken another job for the summer."}'

Try it

It needs a candidate signed in to the portal.

Example answer

200 OKJSON
{  "data": {    "candidate": {      "firstName": "Kari",      "lastName": "Nordmann",      "email": "kari.nordmann@northwilds.com",      "locale": "en"    },    "site": {      "name": "Northwilds",      "privacyVersion": 3,      "contactEmail": "hr@northwilds.com"    },    "applications": [      {        "id": "6651a0c2b9e4c1d2e3f40c01",        "jobTitle": "Trip guide, Lofoten",        "jobUrl": "https://northwilds.com/careers/trip-guide-lofoten",        "stage": "Interviews",        "status": "active",        "appliedAt": "2026-10-24T18:12:00.000Z",        "updatedAt": "2026-11-02T09:30:00.000Z",        "canWithdraw": true,        "canUpload": true,        "files": [          {            "id": "6651a0c2b9e4c1d2e3f40d01",            "name": "kari-nordmann-cv.pdf",            "size": 184220,            "kind": "cv",            "createdAt": "2026-10-24T18:12:00.000Z"          }        ]      }    ],    "offers": [],    "texting": [      "sms"    ],    "talentPool": {      "member": true,      "until": "2028-10-24T18:12:00.000Z"    },    "requests": [],    "erasureAt": null  }}

Add a document

POST/portal/applications/{id}/documentsKey required

Multipart with file: a PDF or Word document up to 10 MB, at most 20 files an application. Never cached, and it works while Careers Orbit is paused.

Parameters

  • idstringpath, required

    The application's or offer's id.

  • X-Careers-Sessionstringheader, required

    The candidate's portal session, from the session endpoint.

Request body

  • filestringrequired

Responses

  • 200OKThe whole portal again, as GET /portal/me answers.
    • dataPortal

      The candidate's applications, offers, talent pool and requests, or null when signed out.

  • 400Bad requestNo file, a file that is too large or not a PDF or Word file, 20 files already, or an application that isn't open.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 401UnauthorisedNo key or a wrong key, or no portal session or one that has expired.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 403ForbiddenA browser call from a website not on your allowed list.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 404Not foundNo application with that id for this candidate.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 429Too many requestsMore than 30 portal requests a minute from one network, after a burst of 60.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 500Server errorSomething failed on our side. Try again in a moment.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

Shell
curl -X POST 'https://api.bifrostorbit.com/careers/v1/portal/applications/6651a0c2b9e4c1d2e3f40c01/documents' \  -H 'Authorization: Bearer careers_pk_…' \  -H 'X-Careers-Session: …'

Try it

It needs a candidate signed in to the portal.

Example answer

200 OKJSON
{  "data": {    "candidate": {      "firstName": "Kari",      "lastName": "Nordmann",      "email": "kari.nordmann@northwilds.com",      "locale": "en"    },    "site": {      "name": "Northwilds",      "privacyVersion": 3,      "contactEmail": "hr@northwilds.com"    },    "applications": [      {        "id": "6651a0c2b9e4c1d2e3f40c01",        "jobTitle": "Trip guide, Lofoten",        "jobUrl": "https://northwilds.com/careers/trip-guide-lofoten",        "stage": "Interviews",        "status": "active",        "appliedAt": "2026-10-24T18:12:00.000Z",        "updatedAt": "2026-11-02T09:30:00.000Z",        "canWithdraw": true,        "canUpload": true,        "files": [          {            "id": "6651a0c2b9e4c1d2e3f40d01",            "name": "kari-nordmann-cv.pdf",            "size": 184220,            "kind": "cv",            "createdAt": "2026-10-24T18:12:00.000Z"          }        ]      }    ],    "offers": [],    "texting": [      "sms"    ],    "talentPool": {      "member": true,      "until": "2028-10-24T18:12:00.000Z"    },    "requests": [],    "erasureAt": null  }}

Mark offers seen

POST/portal/offersKey required

Notes that the candidate has seen their open offers. Never cached, and it works while Careers Orbit is paused.

Parameters

  • X-Careers-Sessionstringheader, required

    The candidate's portal session, from the session endpoint.

Responses

  • 200OKThe whole portal again, as GET /portal/me answers.
    • dataPortal

      The candidate's applications, offers, talent pool and requests, or null when signed out.

  • 401UnauthorisedNo key or a wrong key, or no portal session or one that has expired.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 403ForbiddenA browser call from a website not on your allowed list.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 429Too many requestsMore than 30 portal requests a minute from one network, after a burst of 60.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 500Server errorSomething failed on our side. Try again in a moment.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

Shell
curl -X POST 'https://api.bifrostorbit.com/careers/v1/portal/offers' \  -H 'Authorization: Bearer careers_pk_…' \  -H 'X-Careers-Session: …'

Try it

It needs a candidate signed in to the portal.

Example answer

200 OKJSON
{  "data": {    "candidate": {      "firstName": "Kari",      "lastName": "Nordmann",      "email": "kari.nordmann@northwilds.com",      "locale": "en"    },    "site": {      "name": "Northwilds",      "privacyVersion": 3,      "contactEmail": "hr@northwilds.com"    },    "applications": [      {        "id": "6651a0c2b9e4c1d2e3f40c01",        "jobTitle": "Trip guide, Lofoten",        "jobUrl": "https://northwilds.com/careers/trip-guide-lofoten",        "stage": "Interviews",        "status": "active",        "appliedAt": "2026-10-24T18:12:00.000Z",        "updatedAt": "2026-11-02T09:30:00.000Z",        "canWithdraw": true,        "canUpload": true,        "files": [          {            "id": "6651a0c2b9e4c1d2e3f40d01",            "name": "kari-nordmann-cv.pdf",            "size": 184220,            "kind": "cv",            "createdAt": "2026-10-24T18:12:00.000Z"          }        ]      }    ],    "offers": [],    "texting": [      "sms"    ],    "talentPool": {      "member": true,      "until": "2028-10-24T18:12:00.000Z"    },    "requests": [],    "erasureAt": null  }}

Answer an offer

POST/portal/offers/{id}/answerKey required

action accept with name, consent: true and documentHash signs the offer; action decline with an optional reason, up to 1,000 characters, declines it. Never cached, and it works while Careers Orbit is paused.

Parameters

  • idstringpath, required

    The application's or offer's id.

  • X-Careers-Sessionstringheader, required

    The candidate's portal session, from the session endpoint.

Request body

  • actionstringrequired

    One of accept, decline.
  • namestringoptional

  • consentbooleanoptional

  • documentHashstringoptional

  • reasonstringoptional

Responses

  • 200OKThe whole portal again, as GET /portal/me answers.
    • dataPortal

      The candidate's applications, offers, talent pool and requests, or null when signed out.

  • 400Bad requestNo action, a missing name or consent, an offer that changed, expired or was already answered.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 401UnauthorisedNo key or a wrong key, or no portal session or one that has expired.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 403ForbiddenA browser call from a website not on your allowed list.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 404Not foundNo offer with that id for this candidate.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 422UnprocessableA field has the wrong type.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 429Too many requestsMore than 30 portal requests a minute from one network, after a burst of 60.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 500Server errorSomething failed on our side. Try again in a moment.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

Shell
curl -X POST 'https://api.bifrostorbit.com/careers/v1/portal/offers/6651a0c2b9e4c1d2e3f40c01/answer' \  -H 'Authorization: Bearer careers_pk_…' \  -H 'X-Careers-Session: …' \  -H 'Content-Type: application/json' \  -d '{"action":"accept","name":"Kari Nordmann","consent":true,"documentHash":"…"}'

Try it

It needs a candidate signed in to the portal.

Example answer

200 OKJSON
{  "data": {    "candidate": {      "firstName": "Kari",      "lastName": "Nordmann",      "email": "kari.nordmann@northwilds.com",      "locale": "en"    },    "site": {      "name": "Northwilds",      "privacyVersion": 3,      "contactEmail": "hr@northwilds.com"    },    "applications": [      {        "id": "6651a0c2b9e4c1d2e3f40c01",        "jobTitle": "Trip guide, Lofoten",        "jobUrl": "https://northwilds.com/careers/trip-guide-lofoten",        "stage": "Interviews",        "status": "active",        "appliedAt": "2026-10-24T18:12:00.000Z",        "updatedAt": "2026-11-02T09:30:00.000Z",        "canWithdraw": true,        "canUpload": true,        "files": [          {            "id": "6651a0c2b9e4c1d2e3f40d01",            "name": "kari-nordmann-cv.pdf",            "size": 184220,            "kind": "cv",            "createdAt": "2026-10-24T18:12:00.000Z"          }        ]      }    ],    "offers": [],    "texting": [      "sms"    ],    "talentPool": {      "member": true,      "until": "2028-10-24T18:12:00.000Z"    },    "requests": [],    "erasureAt": null  }}

Download an offer

GET/portal/offers/{id}/pdfKey required

The offer as a PDF, signed once accepted. Never cached, and it works while Careers Orbit is paused.

Parameters

  • idstringpath, required

    The application's or offer's id.

  • X-Careers-Sessionstringheader, required

    The candidate's portal session, from the session endpoint.

Responses

  • 200OKThe PDF.

    application/pdf

  • 401UnauthorisedNo key or a wrong key, or no portal session or one that has expired.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 403ForbiddenA browser call from a website not on your allowed list.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 404Not foundNo offer with that id for this candidate.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 429Too many requestsMore than 30 portal requests a minute from one network, after a burst of 60.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 500Server errorSomething failed on our side. Try again in a moment.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

Shell
curl 'https://api.bifrostorbit.com/careers/v1/portal/offers/6651a0c2b9e4c1d2e3f40c01/pdf' \  -H 'Authorization: Bearer careers_pk_…' \  -H 'X-Careers-Session: …'

Try it

It needs a candidate signed in to the portal.

Open a data request

POST/portal/requestsKey required

kind erasure, or kind correction with detail up to 2,000 characters. A second open request of the same kind changes nothing. Never cached, and it works while Careers Orbit is paused.

Parameters

  • X-Careers-Sessionstringheader, required

    The candidate's portal session, from the session endpoint.

Request body

  • kindstringrequired

    One of erasure, correction.
  • detailstringoptional

Responses

  • 200OKThe whole portal again, as GET /portal/me answers.
    • dataPortal

      The candidate's applications, offers, talent pool and requests, or null when signed out.

  • 400Bad requestA correction without detail.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 401UnauthorisedNo key or a wrong key, or no portal session or one that has expired.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 403ForbiddenA browser call from a website not on your allowed list.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 422Unprocessablekind is missing or unknown.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 429Too many requestsMore than 30 portal requests a minute from one network, after a burst of 60.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 500Server errorSomething failed on our side. Try again in a moment.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

Shell
curl -X POST 'https://api.bifrostorbit.com/careers/v1/portal/requests' \  -H 'Authorization: Bearer careers_pk_…' \  -H 'X-Careers-Session: …' \  -H 'Content-Type: application/json' \  -d '{"kind":"correction","detail":"My phone number is now +47 912 34 567."}'

Try it

It needs a candidate signed in to the portal.

Example answer

200 OKJSON
{  "data": {    "candidate": {      "firstName": "Kari",      "lastName": "Nordmann",      "email": "kari.nordmann@northwilds.com",      "locale": "en"    },    "site": {      "name": "Northwilds",      "privacyVersion": 3,      "contactEmail": "hr@northwilds.com"    },    "applications": [      {        "id": "6651a0c2b9e4c1d2e3f40c01",        "jobTitle": "Trip guide, Lofoten",        "jobUrl": "https://northwilds.com/careers/trip-guide-lofoten",        "stage": "Interviews",        "status": "active",        "appliedAt": "2026-10-24T18:12:00.000Z",        "updatedAt": "2026-11-02T09:30:00.000Z",        "canWithdraw": true,        "canUpload": true,        "files": [          {            "id": "6651a0c2b9e4c1d2e3f40d01",            "name": "kari-nordmann-cv.pdf",            "size": 184220,            "kind": "cv",            "createdAt": "2026-10-24T18:12:00.000Z"          }        ]      }    ],    "offers": [],    "texting": [      "sms"    ],    "talentPool": {      "member": true,      "until": "2028-10-24T18:12:00.000Z"    },    "requests": [],    "erasureAt": null  }}

Stay in the talent pool

POST/portal/talent-pool/stayKey required

Renews talent pool consent. Never cached, and it works while Careers Orbit is paused.

Parameters

  • X-Careers-Sessionstringheader, required

    The candidate's portal session, from the session endpoint.

Responses

  • 200OKThe whole portal again, as GET /portal/me answers.
    • dataPortal

      The candidate's applications, offers, talent pool and requests, or null when signed out.

  • 401UnauthorisedNo key or a wrong key, or no portal session or one that has expired.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 403ForbiddenA browser call from a website not on your allowed list.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 429Too many requestsMore than 30 portal requests a minute from one network, after a burst of 60.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 500Server errorSomething failed on our side. Try again in a moment.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

Shell
curl -X POST 'https://api.bifrostorbit.com/careers/v1/portal/talent-pool/stay' \  -H 'Authorization: Bearer careers_pk_…' \  -H 'X-Careers-Session: …'

Try it

It needs a candidate signed in to the portal.

Example answer

200 OKJSON
{  "data": {    "candidate": {      "firstName": "Kari",      "lastName": "Nordmann",      "email": "kari.nordmann@northwilds.com",      "locale": "en"    },    "site": {      "name": "Northwilds",      "privacyVersion": 3,      "contactEmail": "hr@northwilds.com"    },    "applications": [      {        "id": "6651a0c2b9e4c1d2e3f40c01",        "jobTitle": "Trip guide, Lofoten",        "jobUrl": "https://northwilds.com/careers/trip-guide-lofoten",        "stage": "Interviews",        "status": "active",        "appliedAt": "2026-10-24T18:12:00.000Z",        "updatedAt": "2026-11-02T09:30:00.000Z",        "canWithdraw": true,        "canUpload": true,        "files": [          {            "id": "6651a0c2b9e4c1d2e3f40d01",            "name": "kari-nordmann-cv.pdf",            "size": 184220,            "kind": "cv",            "createdAt": "2026-10-24T18:12:00.000Z"          }        ]      }    ],    "offers": [],    "texting": [      "sms"    ],    "talentPool": {      "member": true,      "until": "2028-10-24T18:12:00.000Z"    },    "requests": [],    "erasureAt": null  }}

Leave the talent pool

POST/portal/talent-pool/leaveKey required

Withdraws talent pool consent. Never cached, and it works while Careers Orbit is paused.

Parameters

  • X-Careers-Sessionstringheader, required

    The candidate's portal session, from the session endpoint.

Responses

  • 200OKThe whole portal again, as GET /portal/me answers.
    • dataPortal

      The candidate's applications, offers, talent pool and requests, or null when signed out.

  • 401UnauthorisedNo key or a wrong key, or no portal session or one that has expired.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 403ForbiddenA browser call from a website not on your allowed list.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 429Too many requestsMore than 30 portal requests a minute from one network, after a burst of 60.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 500Server errorSomething failed on our side. Try again in a moment.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

Shell
curl -X POST 'https://api.bifrostorbit.com/careers/v1/portal/talent-pool/leave' \  -H 'Authorization: Bearer careers_pk_…' \  -H 'X-Careers-Session: …'

Try it

It needs a candidate signed in to the portal.

Example answer

200 OKJSON
{  "data": {    "candidate": {      "firstName": "Kari",      "lastName": "Nordmann",      "email": "kari.nordmann@northwilds.com",      "locale": "en"    },    "site": {      "name": "Northwilds",      "privacyVersion": 3,      "contactEmail": "hr@northwilds.com"    },    "applications": [      {        "id": "6651a0c2b9e4c1d2e3f40c01",        "jobTitle": "Trip guide, Lofoten",        "jobUrl": "https://northwilds.com/careers/trip-guide-lofoten",        "stage": "Interviews",        "status": "active",        "appliedAt": "2026-10-24T18:12:00.000Z",        "updatedAt": "2026-11-02T09:30:00.000Z",        "canWithdraw": true,        "canUpload": true,        "files": [          {            "id": "6651a0c2b9e4c1d2e3f40d01",            "name": "kari-nordmann-cv.pdf",            "size": 184220,            "kind": "cv",            "createdAt": "2026-10-24T18:12:00.000Z"          }        ]      }    ],    "offers": [],    "texting": [      "sms"    ],    "talentPool": {      "member": true,      "until": "2028-10-24T18:12:00.000Z"    },    "requests": [],    "erasureAt": null  }}

Stop text messages

POST/portal/texting/stopKey required

Stops text messages on one channel. Never cached, and it works while Careers Orbit is paused.

Parameters

  • X-Careers-Sessionstringheader, required

    The candidate's portal session, from the session endpoint.

Request body

  • channelstringrequired

    One of sms, whatsapp.

Responses

  • 200OKThe whole portal again, as GET /portal/me answers.
    • dataPortal

      The candidate's applications, offers, talent pool and requests, or null when signed out.

  • 400Bad requestAn unknown channel.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 401UnauthorisedNo key or a wrong key, or no portal session or one that has expired.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 403ForbiddenA browser call from a website not on your allowed list.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 429Too many requestsMore than 30 portal requests a minute from one network, after a burst of 60.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

  • 500Server errorSomething failed on our side. Try again in a moment.
    • errorobject

      Fields of error
      • codestring

        unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

      • messagestring

        A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

    • issuesany[]sometimes

      On 422: the fields that failed.

Shell
curl -X POST 'https://api.bifrostorbit.com/careers/v1/portal/texting/stop' \  -H 'Authorization: Bearer careers_pk_…' \  -H 'X-Careers-Session: …' \  -H 'Content-Type: application/json' \  -d '{"channel":"sms"}'

Try it

It needs a candidate signed in to the portal.

Example answer

200 OKJSON
{  "data": {    "candidate": {      "firstName": "Kari",      "lastName": "Nordmann",      "email": "kari.nordmann@northwilds.com",      "locale": "en"    },    "site": {      "name": "Northwilds",      "privacyVersion": 3,      "contactEmail": "hr@northwilds.com"    },    "applications": [      {        "id": "6651a0c2b9e4c1d2e3f40c01",        "jobTitle": "Trip guide, Lofoten",        "jobUrl": "https://northwilds.com/careers/trip-guide-lofoten",        "stage": "Interviews",        "status": "active",        "appliedAt": "2026-10-24T18:12:00.000Z",        "updatedAt": "2026-11-02T09:30:00.000Z",        "canWithdraw": true,        "canUpload": true,        "files": [          {            "id": "6651a0c2b9e4c1d2e3f40d01",            "name": "kari-nordmann-cv.pdf",            "size": 184220,            "kind": "cv",            "createdAt": "2026-10-24T18:12:00.000Z"          }        ]      }    ],    "offers": [],    "texting": [      "sms"    ],    "talentPool": {      "member": true,      "until": "2028-10-24T18:12:00.000Z"    },    "requests": [],    "erasureAt": null  }}

SchemasThe shapes the endpoints above answer with and take.

Error

Every error has this shape. Write code against the status and code, never the message.

  • errorobject

    Fields of error
    • codestring

      unauthorized, forbidden, not_found, subscription_inactive, invalid, conflict, rate_limited or server_error.

    • messagestring

      A message people can read. Messages meant for candidates follow their language where Careers Orbit has it; the rest are in English.

  • issuesany[]sometimes

    On 422: the fields that failed.

Location

  • idstring

  • namestring

  • streetstring

  • postalCodestring

  • citystring

  • regionstring

  • countrystring

  • remotestring

    One of onsite, hybrid, remote.

Salary

  • mininteger or null

  • maxinteger or null

  • currencystring

  • periodstring

    One of year, month, hour.
  • textstring

    Ready to show, such as 42.000 NOK – 48.000 NOK pro Monat.

Job

  • idstring

  • slugstring

  • urlstring

    On your website if you set job addresses, otherwise on your hosted pages.

  • titlestring

  • summarystring

  • departmentobject or null

    Fields of department
    • idstring

    • namestring

  • locationsLocation[]

    Fields of Location

  • employmentTypestring

    One of fullTime, partTime, contract, temporary, internship, apprenticeship, workingStudent.
  • employmentTypeLabelstring

  • remotestring

    One of onsite, hybrid, remote.
  • remoteLabelstring

  • salarySalary or any or null

    Only when you chose to show it.

    Fields of salary

    One of:

    Salary

    • mininteger or null

    • maxinteger or null

    • currencystring

    • periodstring

      One of year, month, hour.
    • textstring

      Ready to show, such as 42.000 NOK – 48.000 NOK pro Monat.

    any or null

  • publishedAtstring

  • closesAtstring or null

  • internalboolean

    Internal-only. Only keys that read internal jobs see these.

Question

  • idstring

    The key in answers, and in file:<id> for a file question.

  • kindstring

    One of text, longText, choice, multiChoice, yesNo, file, date, number.
  • labelstring

  • helpstring

  • requiredboolean

  • optionsobject[]

    Fields of options
    • idstring

      What a choice answer sends.

    • labelstring

JobDetail

  • idstring

  • slugstring

  • urlstring

    On your website if you set job addresses, otherwise on your hosted pages.

  • titlestring

  • summarystring

  • departmentobject or null

    Fields of department
    • idstring

    • namestring

  • locationsLocation[]

    Fields of Location

  • employmentTypestring

    One of fullTime, partTime, contract, temporary, internship, apprenticeship, workingStudent.
  • employmentTypeLabelstring

  • remotestring

    One of onsite, hybrid, remote.
  • remoteLabelstring

  • salarySalary or any or null

    Only when you chose to show it.

    Fields of salary

    One of:

    Salary

    • mininteger or null

    • maxinteger or null

    • currencystring

    • periodstring

      One of year, month, hour.
    • textstring

      Ready to show, such as 42.000 NOK – 48.000 NOK pro Monat.

    any or null

  • publishedAtstring

  • closesAtstring or null

  • internalboolean

    Internal-only. Only keys that read internal jobs see these.

  • localestring

    The language used.

  • localesstring[]

    Languages the job is in.

  • fallbackstring[]

    Fields that came in the main language.

  • descriptionstring

    Cleaned HTML.

  • seoobject

    Fields of seo
    • titlestring

    • descriptionstring

  • cmsEntryIdstring or null

    The CMS Orbit entry for the job page, when linked.

  • formobject

    What to ask, without screening rules.

    Fields of form
    • fieldsmap of string

      Standard fields: phone, cv, coverLetter, linkedin, location, salaryExpectation, startDate.

    • questionsQuestion[]

      Fields of Question

  • privacyobject

    Fields of privacy
    • versioninteger

      Send as privacyVersion.

    • textstring

  • jobPostingmap of any

    schema.org JobPosting, for a ld+json script for Google for Jobs.

Filters

  • departmentsobject[]

    Fields of departments
    • valuestring

    • labelstring

    • countinteger

      Live jobs with it.

  • locationsobject[]

    Fields of locations
    • valuestring

    • labelstring

    • countinteger

    • citystring

    • countrystring

  • employmentTypesobject[]

    Fields of employmentTypes
    • valuestring

    • labelstring

    • countinteger

      Live jobs with it.

  • remoteobject[]

    Fields of remote
    • valuestring

    • labelstring

    • countinteger

      Live jobs with it.

Site

  • namestring

  • slugstring

  • introstring

  • logoUrlstring or null

  • coloursobject

    Fields of colours
    • brandstring or null

    • accentstring or null

  • localestring

  • languagesstring[]

  • defaultLanguagestring

  • contactEmailstring or null

  • websiteUrlstring or null

  • hostedUrlstring

  • privacyobject

    The notice candidates agree to.

    Fields of privacy
    • versioninteger

    • textstring

  • insightsobject or null

    Fields of insights
    • sitestring

      The Insights Orbit site key.

  • textingobject or null

    Fields of texting
    • smsboolean

    • whatsappboolean

ApplicationInput

  • firstNamestring

    Up to 80 characters.
  • lastNamestring

    Up to 80 characters.
  • emailstring

    Up to 200 characters.
  • phonestring or nullsometimes

    Up to 40 characters.
  • coverLetterstring or nullsometimes

    Up to 10000 characters.
  • linkedinstring or nullsometimes

    Up to 300 characters.
  • locationstring or nullsometimes

    Up to 120 characters.
  • salaryExpectationstring or nullsometimes

    Up to 120 characters.
  • startDatestring or nullsometimes

    Up to 40 characters.
  • answersmap of anysometimes

    By question id. Choice answers are option ids; yes or no answers are yes or no.

  • privacyVersioninteger

    The job's privacy.version. If the notice changed since, the call fails with a request to reload.

  • privacyAcceptedtrue

  • talentPoolbooleansometimes

  • textingstring[]sometimes

  • localestringsometimes

  • sourcestringsometimes

    Such as northwilds.com.

    Up to 60 characters.
  • utmobjectsometimes

    Fields of utm
    • sourcestring or nullsometimes

    • mediumstring or nullsometimes

    • campaignstring or nullsometimes

  • referrerstring or nullsometimes

  • referralstring or nullsometimes

    The ref from a colleague's referral link.

TalentPoolInput

  • firstNamestring

    Up to 80 characters.
  • lastNamestringsometimes

    Up to 80 characters.
  • emailstring

  • privacyVersioninteger

  • privacyAcceptedtrue

  • localestringsometimes

  • jobAlertsbooleansometimes

    Email when a new job opens.

  • departmentIdsstring[]sometimes

    Only jobs in these departments.

    Up to 30 items.

Portal

The candidate's applications, offers, talent pool and requests, or null when signed out.