REST /api/v1/deep-links 4 endpoints
GET /api/v1/deep-links/api/v1/deep-links

List recorded incoming deep links

Public

Response Example

{
  "data": [
    {
      "link_id": "dl_9a8b7c6d",
      "uri": "myapp://vipps-callback?code=auth_code_aBcDeFgH1234&state=rnd9xkT2",
      "type": "vipps",
      "processed": true,
      "received_at": "2026-03-26T10:11:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1
  }
}
POST /api/v1/deep-links/api/v1/deep-links/parse

Parse an OAuth callback URI into structured fields

Public

Request Example

{
  "uri": "myapp://vipps-callback?code=auth_code_aBcDeFgH1234&state=rnd9xkT2"
}

Response Example

{
  "provider": "vipps",
  "code": "auth_code_aBcDeFgH1234",
  "state": "rnd9xkT2",
  "error": null,
  "error_description": null
}
GET /api/v1/deep-links/api/v1/deep-links/initial

Get the initial deep link that launched the app

Public

Response Example

{
  "uri": "myapp://bankid-callback?session=bids_3e9c1f2a&assertion=eyJhbGc...",
  "received_at": "2026-03-26T10:10:30Z"
}
POST /api/v1/deep-links/api/v1/deep-links/initialize

Initialize deep link listener for the session

Public

Request Example

{
  "device_id": "dev_mobile_01"
}

Response Example

{
  "initialized": true,
  "listening": true,
  "initialized_at": "2026-03-26T10:00:00Z"
}

Additional Metadata

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