List jobber

GET /api/v1/jobs gir jobbene i arbeidsområdet, én side om gangen, med alle parametere og felt.

Oversikt⁠

GET /api/v1/jobs lister jobbene i arbeidsområdet ditt. Du får jobbene du kan se i appen, bortsett fra team som nøkkelens teamtilgang utelater. Nøkkelen trenger tillatelsen Lese.

Attia-API-et dekker nøkler, feil og rategrenser. Denne siden dekker parameterne og feltene.

Forespørsel⁠

curl "https://attia.app/api/v1/jobs?limit=50" \  -H "Authorization: Bearer $ATTIA_API_KEY"

Alle de fire spørreparameterne er valgfrie.

Parameter	Type	Standard	Betydning
`limit`	heltall, 1 til 100	25	Hvor mange jobber du får
`cursor`	streng	ingen	`next_cursor` fra forrige side
`updated_since`	RFC 3339-tidsstempel	ingen	Bare jobber oppdatert på eller etter dette tidspunktet
`include_archived`	`true` eller `false`	`false`	Ta også med arkiverte jobber

En parameter utenfor denne tabellen gir 400 med koden invalid-request. Det samme gjør en parameter som er sendt to ganger.

Svar⁠

Svaret har jobbene i data, sortert etter updated_at og deretter id, eldste endring først. next_cursor er en streng når det finnes flere jobber, og null på siste side.

{  "data": [    {      "id": "0192f3a1-6b02-7d4c-8e11-5a9c0b7d3e01",      "title": "Backend-utvikler",      "slug": "backend-utvikler",      "status": "live",      "team_id": "0192f39f-11aa-7c3e-b2d4-9e8f7a6b5c4d",      "employment_type": "full_time",      "contract_type": "permanent",      "workplace_type": "hybrid",      "locations": ["Eksempelvik"],      "positions_count": 2,      "application_deadline": "2026-11-15",      "published_at": "2026-09-28T07:30:00.000000Z",      "closed_at": null,      "archived_at": null,      "created_at": "2026-09-25T12:04:51.220417Z",      "updated_at": "2026-10-01T09:42:10.118305Z"    }  ],  "next_cursor": null}

Felt	Type	Betydning
`id`	UUID	Jobbens id. Den endrer seg aldri
`title`	streng	Stillingstittelen
`slug`	streng	Jobbens navn i URL-en, unikt i arbeidsområdet
`status`	enum	`draft`, `live`, `paused` eller `closed`. Om kandidater kan søke, det appen kaller Publisering. Se Jobbstatus
`team_id`	UUID	Teamet som eier jobben
`employment_type`	enum	`full_time` eller `part_time`
`contract_type`	enum	`permanent`, `temporary`, `fixed_contract`, `seasonal`, `project`, `trainee`, `apprenticeship`, `self_employed` eller `agency`
`workplace_type`	enum	`remote`, `hybrid` eller `onsite`
`locations`	liste med strenger	Stedene jobben oppgir. Tom når den ikke oppgir noen
`positions_count`	heltall	Hvor mange jobben skal ansette, minst 1
`application_deadline`	dato eller `null`	Siste dag for å søke, `YYYY-MM-DD`
`published_at`	tidsstempel eller `null`	Når jobben ble publisert
`closed_at`	tidsstempel eller `null`	Når jobben ble lukket
`archived_at`	tidsstempel eller `null`	Når jobben ble arkivert
`created_at`	tidsstempel	Når jobben ble opprettet
`updated_at`	tidsstempel	Når jobben sist ble endret

En enum kan få en ny verdi i versjon 1, så koden din må tåle en verdi den ikke kjenner.

Bla gjennom alle jobbene⁠

Be om en side, og send next_cursor tilbake som cursor til den er null.

curl "https://attia.app/api/v1/jobs?limit=100&cursor=eyJ1IjoiMjAyNi0xMC0wMlQwODoxNTozMC40ODI5MTNaIiwiaSI6IjAxOTJmM2ExLTdjNDQtN2IxZS05YTUwLTNmMWQyYzZlOGEwMiJ9" \  -H "Authorization: Bearer $ATTIA_API_KEY"

Cursoren holder seg stabil mens folk redigerer jobber. En jobb som blir redigert mens du leser, flytter seg bak cursoren, og du kan få den igjen på en senere side. Behold den nyeste kopien per id.

Hent endringer jevnlig⁠

updated_since er inkluderende. Send et tidspunkt fem minutter før den største updated_at du har lagret. En endring får sin updated_at når lagringen starter, så den kan dukke opp med et tidspunkt som er eldre enn et du allerede har lest. Svaret gjentar jobber du allerede har, så fjern gjentakelsene etter id. Med 2026-10-01T09:42:10.118305Z som den største blir kallet slik.

curl "https://attia.app/api/v1/jobs?updated_since=2026-10-01T09:37:10.118305Z" \  -H "Authorization: Bearer $ATTIA_API_KEY"

Du kan kombinere updated_since med cursor og limit når én henting gir mer enn en side.

Arkiverte jobber⁠

Listen utelater arkiverte jobber hvis du ikke ber om dem. Det betyr noe når du holder en kopi. En jobb som noen arkiverer, forsvinner fra standardlisten, og kopien din får aldri vite hvorfor. Send include_archived=true når du henter endringer, så kommer en arkivert jobb tilbake med et tidspunkt i archived_at.

curl "https://attia.app/api/v1/jobs?include_archived=true&updated_since=2026-10-01T00:00:00Z" \  -H "Authorization: Bearer $ATTIA_API_KEY"