Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »


  • You need to register a client on MyPage before you can access the API.
  • Create an access token using client_credentials, and send this as a bearer token header.

Table of contents:

How to register your application

To use the BarentsWatch API application developers must register their applications with BarentsWatch. Please see: (Norwegain / English)

Please see for information in Norwegian about how to obtain an API user or send an e-mail to 

The API supports Open ID Connect flows like client credentials, authorization code, and device code. Self registered clients only supports client_credentials. You must contact BarentsWatch to set up other types of clients.

The OpenID discovery document is here: (production).

How to request an access token

You need ClientID and ClientSecret from self-registration on MyPage/Minside, or obtained from BarentsWatch.

An application can obtain a token for use with the BarentsWatch API by posting a token request via HTTPS to

  • URL must be
  • Header-parameter 'content-type' must be 'application/x-www-form-urlencoded'
  • Parameter 'grant_type' must be 'client_credentials'
  • Parameter 'client_id' must be provided - use full ID which is often on the form If your client does not url-encode automatically, you must url-encode it on the form
  • Parameter 'client_secret' must be provided
  • Parameter scope must be 'api'

Example request using curl:

curl -X POST --header "Content-Type: application/x-www-form-urlencoded" -d "client_id=YOUR_CLIENT_ID&scope=api&client_secret=YOUR_CLIENT_SECRET&grant_type=client_credentials"

Example success response:


For more information see

How to use your access token to access the API

This is an example request to the BarentsWatch API for getting available forecast times for a particular fairway.

GET /bwapi/v1/geodata/waveforecast/available/?modelname=folda&fairwayid=1 HTTP/1.1
User-Agent: My Application Name
Content-Type: application/x-www-form-urlencoded
Authorization: bearer MTQ0NjJkZmQ5OTM2NDE1ZTZjNGZmZjI3

The same request with curl:

curl -X GET "" --header  "accept: text/plain" --header  "Authorization: Bearer MTQ0NjJkZmQ5OTM2NDE1ZTZjNGZmZjI3"

These external websites might be useful for developers:

How to log in to the OpenAPI documentation

You can log in to the OpenAPI-documentation with your own client.

  • Go to
  • Click 'Authorize'
  • Under the headline "oauth2 (OAuth2, clientCredentials)":
    • Replace client_id with your own client_id. It has to be URL-encoded. You can copy your URL-encoded client_id from MyPage/Minside.
    • Enter your client_secret
    • Select 'api' scope (tick the box)
  • Click 'Authorize', and then 'Close'

You are now logged in. You can select the API documentation in the dropdown-menu in the upper-right corner.

  • No labels