Kontaktinformasjon
Uthenting og søk i kontaktinformasjon for virksomheter
På denne siden:
Hente kontaktinformasjon for alle organisasjoner
GET https://www.altinn.no/api/serviceowner/organizations?ForceEIAuthentication HTTP/1.1
Accept: application/hal+json
ApiKey: myKey
Eksempel på respons:
{
"_links": {
"self": {
"href": "https://www.altinn.no/api/serviceowner/organizations"
}
},
"_embedded": {
"organizations": [
{
"Name": "HERDLA OG SAULAND",
"OrganizationNumber": "010000211",
"Type": "IS",
"LastChanged": "2014-11-05T00:00:00",
"LastConfirmed": null,
"_links": {
"self": {
"href": "https://www.altinn.no/api/serviceowner/organizations/010000211"
},
"personalcontacts": {
"href": "https://www.altinn.no/api/serviceowner/organizations/010000211/personalcontacts"
},
"officialcontacts": {
"href": "https://www.altinn.no/api/serviceowner/organizations/010000211/officialcontacts"
}
}
}
]
}
}
Søke opp kontaktpunkt i organisasjoner
Søke opp kontaktpunkt i organisasjoner ved hjelp av e-post og/eller telefon.
GET https://www.altinn.no/api/serviceowner/organizations?ForceEIAuthentication&email={email}&phoneNumber={phonenumber} HTTP/1.1
Accept: application/hal+json
ApiKey: myKey
Eksempel på respons:
{
"_links": {
"self": {
"href": "https://www.altinn.no/api/serviceowner/organizations"
}
},
"_embedded": {
"organizations": [
{
"Name": "KYSTBASEN ÅGOTNES OG ILSENG REGNSKAP",
"OrganizationNumber": "910514318",
"Type": "ASA",
"LastChanged": "2015-10-27T12:43:02.23",
"LastConfirmed": "2017-03-22T10:42:34.713",
"_links": {
"self": {
"href": "https://www.altinn.no/api/serviceowner/organizations/910514318"
},
"personalcontacts": {
"href": "https://www.altinn.no/api/serviceowner/organizations/910514318/personalcontacts"
},
"officialcontacts": {
"href": "https://www.altinn.no/api/serviceowner/organizations/910514318/officialcontacts"
}
}
},
{
"Name": "LEINSTRAND OG HOMBORSUND",
"OrganizationNumber": "810748532",
"Type": "BEDR",
"LastChanged": null,
"LastConfirmed": null,
"_links": {
"self": {
"href": "https://www.altinn.no/api/serviceowner/organizations/810748532"
},
"personalcontacts": {
"href": "https://www.altinn.no/api/serviceowner/organizations/810748532/personalcontacts"
},
"officialcontacts": {
"href": "https://www.altinn.no/api/serviceowner/organizations/810748532/officialcontacts"
}
}
}
]
}
}
Hente kontaktinformasjon for én organisasjon
GET https://www.altinn.no/api/serviceowner/organizations/{who}/?ForceEIAuthentication HTTP/1.1
Accept: application/hal+json
ApiKey: myKey
Eksempel på respons:
{
"Name": "HERDLA OG SAULAND",
"OrganizationNumber": "010000211",
"Type": "IS",
"LastChanged": "2014-11-05T00:00:00",
"LastConfirmed": null,
"_links": {
"self": {
"href": "https://www.altinn.no/api/serviceowner/organizations/010000211"
},
"personalcontacts": {
"href": "https://www.altinn.no/api/serviceowner/organizations/010000211/personalcontacts"
},
"officialcontacts": {
"href": "https://www.altinn.no/api/serviceowner/organizations/010000211/officialcontacts"
}
}
}
Hente offisiell kontaktinformasjon for én organisasjon
Dette tilsvarer “Felles kontaktinformasjon for virksomheten” på altinn.no.
GET https://www.altinn.no/api/serviceowner/organizations/{who}/officialcontacts/?ForceEIAuthentication HTTP/1.1
Accept: application/hal+json
ApiKey: myKey
Eksempel på respons:
{
"_links": {
"self": {
"href": "https://www.altinn.no/api/serviceowner/organizations/910021451/officialcontacts"
}
},
"_embedded": {
"officialcontacts": [
{
"MobileNumber": "22334455",
"MobileNumberChanged": "2017-06-15T09:07:20.84",
"EMailAddress": "34234324@gg.com",
"EMailAddressChanged": "2017-06-15T09:07:20.84"
},
{
"MobileNumber": "33445566",
"MobileNumberChanged": "2017-06-15T09:07:20.84",
"EMailAddress": "eeee@bb.com",
"EMailAddressChanged": "2017-06-15T09:07:20.84"
}
]
}
}
Hente personlig kontaktinformasjon for én organisasjon
Dette er en liste over det de forskjellige med roller og rettigheter i en organisasjon har registrert under “Min kontaktinformasjon for virksomheten” på altinn.no.
GET https://www.altinn.no/api/serviceowner/organizations/{who}/personalcontacts/?ForceEIAuthentication&roleDefinitionCode={roleDefinitionCode}&serviceCode={serviceCode}&serviceEdition={serviceEdition} HTTP/1.1
Accept: application/hal+json
ApiKey: myKey
Eksempel på respons:
{
"_links": {
"self": {
"href": "https://www.altinn.no/api/serviceowner/organizations/910021451/personalcontacts"
}
},
"_embedded": {
"personalcontacts": [
{
"PersonalContactId": "r50022994",
"Name": "ROLF BJØRN ",
"SocialSecurityNumber": "06117701547",
"MobileNumber": "12345678",
"MobileNumberChanged": "2017-06-15T09:05:00.86",
"EMailAddress": "eok@br.no",
"EMailAddressChanged": "2017-06-15T09:05:00.86",
"_links": {
"roles": {
"href": "https://www.altinn.no/api/serviceowner/organizations/910021451/personalcontacts/r50022994/roles"
}
}
},
{
"PersonalContactId": "r50041943",
"Name": "DRAGE TARALD",
"SocialSecurityNumber": "11106700992",
"MobileNumber": "12345678",
"MobileNumberChanged": "2016-06-22T14:17:11.23",
"EMailAddress": "pubg@gg.kd",
"EMailAddressChanged": "2016-06-22T14:17:11.23",
"_links": {
"roles": {
"href": "https://www.altinn.no/api/serviceowner/organizations/910021451/personalcontacts/r50041943/roles"
}
}
}
]
}
}
Hente roller for person {person} med oppført kontaktinformasjon på vegne av {who}
Personidentifikatoren er altinn-id-en (r{id}) kalt {PersonalContactId} fra eksempelrespons på personalcontacts.
GET https://www.altinn.no/api/serviceowner/organizations/{who}/personalcontacts/{person}/roles HTTP/1.1
Accept: application/hal+json
ApiKey: myKey
Eksempel på respons:
{
"_links": {
"self": {
"href": "https://www.altinn.no/api/serviceowner/organizations/910514318/personalcontacts/r50051516/roles"
}
},
"_embedded": {
"roles": [
{
"RoleType": "Altinn",
"RoleDefinitionId": 89,
"RoleName": "Basisrolle",
"RoleDescription": "Rolle som følger automatisk med når en bruker får en annen Altinn-rolle",
"RoleDefinitionCode": "ALLEA",
"_links": {
"roledefinition": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/89"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 8,
"RoleName": "Begrenset signeringsrettighet",
"RoleDescription": "Tilgang til å signere utvalgte skjema og tjenester",
"RoleDefinitionCode": "SISKD",
"_links": {
"roledefinition": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/8"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 12,
"RoleName": "Energi, miljø og klima",
"RoleDescription": "Tilgang til tjenester relatert til energi, miljø og klima",
"RoleDefinitionCode": "UTOMR",
"_links": {
"roledefinition": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/12"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 131,
"RoleName": "Helse-, sosial- og velferdstjenester",
"RoleDescription": "Tilgang til helse-, sosial- og velferdsrelaterte tjenester",
"RoleDefinitionCode": "UIHTL",
"_links": {
"roledefinition": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/131"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 15,
"RoleName": "Klientadministrator",
"RoleDescription": "Tilgang til å administrere klientroller for regnskapsførere og revisorer",
"RoleDefinitionCode": "KLADM",
"_links": {
"roledefinition": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/15"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 134,
"RoleName": "Kommunale tjenester",
"RoleDescription": "Rolle for kommunale tjenester",
"RoleDefinitionCode": "KOMAB",
"_links": {
"roledefinition": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/134"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 3,
"RoleName": "Lønn og personalmedarbeider",
"RoleDescription": "Denne rollen gir rettighet til lønns- og personalrelaterte tjenester.\r\n",
"RoleDefinitionCode": "LOPER",
"_links": {
"roledefinition": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/3"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 5576,
"RoleName": "Parallell signering",
"RoleDescription": "Denne rollen gir rettighet til å signere elementer fra andre avgivere.\r\n",
"RoleDefinitionCode": "PASIG",
"_links": {
"roledefinition": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/5576"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 87,
"RoleName": "Patent, varemerke og design",
"RoleDescription": "Denne rollen gir rettighet til tjenester relatert til patent, varemerke og design.",
"RoleDefinitionCode": "PAVAD",
"_links": {
"roledefinition": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/87"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 5603,
"RoleName": "Post/arkiv",
"RoleDescription": "Denne rollen gir rettighet til å lese meldinger som blir sendt til brukerens meldingsboks.\r\n",
"RoleDefinitionCode": "A0236",
"_links": {
"roledefinition": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/5603"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 272,
"RoleName": "Primærnæring og næringsmiddel",
"RoleDescription": "Denne rollen gir rettighet til tjenester innen import, foredling, produksjon og/eller salg av primærnæringsprodukter og andre næringsmiddel, samt dyrehold, akvakultur, planter og kosmetikk.",
"RoleDefinitionCode": "A0212",
"_links": {
"roledefinition": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/272"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 6,
"RoleName": "Regnskapsmedarbeider",
"RoleDescription": "Denne rollen gir rettighet til regnskapsrelaterte skjema og tjenester.",
"RoleDefinitionCode": "REGNA",
"_links": {
"roledefinition": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/6"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 85,
"RoleName": "Revisorattesterer - MVA kompensasjon",
"RoleDescription": "Denne rollen gir revisor rettighet til å attestere tjenesten Merverdiavgift - søknad om kompensasjon (RF-0009).",
"RoleDefinitionCode": "ATTST",
"_links": {
"roledefinition": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/85"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 10,
"RoleName": "Samferdsel",
"RoleDescription": "Rollen gir rettighet til tjenester relatert til samferdsel. For eksempel tjenester fra Statens Vegvesen, Sjøfartsdirektoratet og Luftfartstilsynet.",
"RoleDefinitionCode": "UILUF",
"_links": {
"roledefinition": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/10"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 130,
"RoleName": "Signerer av Samordnet registermelding",
"RoleDescription": "Denne rollen gir rettighet til tjenester på vegne av enheter/foretak.\r\n",
"RoleDefinitionCode": "SIGNE",
"_links": {
"roledefinition": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/130"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 4,
"RoleName": "Tilgangsstyring",
"RoleDescription": "Denne rollen gir administratortilgang til å gi videre rettigheter til andre.\r\n",
"RoleDefinitionCode": "ADMAI",
"_links": {
"roledefinition": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/4"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 11,
"RoleName": "Utfyller/Innsender",
"RoleDescription": "Denne rollen gir rettighet til utvalgte skjema og tjenester.\r\n",
"RoleDefinitionCode": "UTINN",
"_links": {
"roledefinition": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/11"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 86,
"RoleName": "Økokrim rapportering",
"RoleDescription": "Tilgang til tjenester fra Økokrim",
"RoleDefinitionCode": "HVASK",
"_links": {
"roledefinition": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/86"
}
}
}
]
}
}