Vipps Auth Service - API Contract

GET /api/v1/auth/vipps/api/v1/auth/vipps/authorize

Build Vipps OAuth authorization URL for org

Public

Response Example

{
  "authorization_url": "https://api.vipps.no/access-management-1.0/access/oauth2/auth?client_id=vipps-client-abc123&redirect_uri=myapp%3A%2F%2Fvipps-callback&scope=openid+phoneNumber+name&state=rnd9xkT2&code_challenge=E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM&code_challenge_method=S256",
  "state": "rnd9xkT2",
  "code_verifier": "dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk"
}

POST /api/v1/auth/vipps/api/v1/auth/vipps/token

Exchange authorization code for Vipps token set

Public

Request Example

{
  "code": "auth_code_aBcDeFgH1234",
  "code_verifier": "dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk"
}

Response Example

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refresh_token": "rt_xKpQwErTyUiOpAsDfGhJkL",
  "id_token": "eyJhbGciOiJSUzI1NiJ9...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "openid phoneNumber name"
}

GET /api/v1/auth/vipps/api/v1/auth/vipps/userinfo

Fetch Vipps user profile using access token

Public

Response Example

{
  "sub": "c06c4afe-d9e1-4c5d-939a-177d88e9dbcd",
  "name": "Kari Nordmann",
  "given_name": "Kari",
  "family_name": "Nordmann",
  "phone_number": "+4799887766",
  "email": "kari.nordmann@example.no",
  "email_verified": true,
  "nin": "15076500565",
  "birthdate": "1965-07-15"
}

POST /api/v1/auth/vipps/api/v1/auth/vipps/personnummer

Persist NIN (personnummer) for authenticated user

Public

Request Example

{
  "user_id": "usr_7f3a1c9d",
  "nin": "15076500565"
}

Response Example

{
  "user_id": "usr_7f3a1c9d",
  "nin_stored": true,
  "updated_at": "2026-03-26T10:14:00Z"
}

Additional Metadata

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}