BankID Provider Client

List BankID provider sessions

{
  "data": [
    {
      "session_id": "bids_3e9c1f2a",
      "org_id": "org_helseapp",
      "status": "completed",
      "created_at": "2026-03-26T09:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1
  }
}

Create a new BankID provider session

{
  "org_id": "org_helseapp"
}

{
  "session_id": "bids_3e9c1f2a",
  "org_id": "org_helseapp",
  "status": "initiated",
  "expires_at": "2026-03-26T10:20:00Z",
  "created_at": "2026-03-26T10:10:00Z"
}

Get the BankID authentication redirect URL for a session

{
  "session_id": "bids_3e9c1f2a",
  "redirect_url": "https://bankid.no/auth?session=bids_3e9c1f2a&nonce=qWxYz123&client_id=bid-client-def456"
}

Validate assertion token against BankID provider

{
  "assertion_token": "eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIxNTA3NjUwMDU2NSJ9..."
}

{
  "valid": true,
  "nin": "15076500565",
  "name": "Kari Nordmann",
  "assurance_level": "substantial",
  "validated_at": "2026-03-26T10:12:45Z"
}

Cancel a BankID provider session

{
  "session_id": "bids_3e9c1f2a",
  "status": "cancelled",
  "cancelled_at": "2026-03-26T10:11:00Z"
}

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