Hente systembruker via spørring

Slik henter du en eksisterende systembruker for eget system ved hjelp av spørreparametere.

Endepunktet lar deg som sluttbrukersystemleverandør (SBSL) hente en eksisterende systembruker for eget system. Du kan slå opp systembrukeren ved å kombinere system-ID og organisasjonsnummer, og eventuelt en ekstern referanse.

Merk: Dette endepunktet brukes til å sjekke om en systembruker eksisterer og hente verdier som systembruker-ID. Det gir ikke tilgang til selve systembruker-tokenet. For å hente token og bruke systembrukeren i API-kall, se Bruk av systembruker.

Du bruker dette endepunktet til å

• supplere eksisterende statusendepunkter for systembrukerforespørsler ved å sjekke om en systembruker faktisk er opprettet
• hente systembruker-ID-en som trengs for å opprette endringsforespørsler
• sjekke detaljer for en eksisterende systembruker

Scope

Kallet autentiseres med et Maskinporten-token som inneholder scopet:

altinn:authentication/systemuser.request.write

Se Kom i gang-veiledningen for informasjon om hvordan du får tilgang til dette scopet.

Endepunkt

• Test (TT02): GET https://platform.tt02.altinn.no/authentication/api/v1/systemuser/vendor/byquery
• Produksjon: GET https://platform.altinn.no/authentication/api/v1/systemuser/vendor/byquery

Spørreparametere

Parameteren external-ref er nyttig dersom det finnes flere systembrukere for samme kombinasjon av system og organisasjon.

Eksempel

Forespørsel

GET https://platform.tt02.altinn.no/authentication/api/v1/systemuser/vendor/byquery
  ?system-id=991825827_smartcloud
  &orgno=314248295
  &external-ref=0.abc123xyz

Svar

{
  "id": "b93107d3-da30-4b7a-a8ae-9b0cac079fd2",
  "integrationTitle": "SmartCloud for Skatt",
  "systemId": "991825827_smartcloud",
  "productName": "",
  "reporteeOrgNo": "314248295",
  "created": "2026-05-21T13:35:24.161Z",
  "isDeleted": false,
  "supplierName": "SmartCloud AS",
  "supplierOrgno": "991825827",
  "externalRef": "0.abc123xyz",
  "userType": "standard"
}

Felter i responsen