Getting Started

Prerequisites

You need an API client issued by EasyPlay:

• a clientId
• a clientSecret

Contact EasyPlay to get credentials for your integration. Your client is granted access to specific clubs — see Authentication for how scopes work.

Base URL

All requests go to:

https://api.easyplay.no

End-to-end example

The flow is always the same: exchange your credentials for a token, then call the API with the token in the Authorization header.

1. Get a token

curl -X POST https://api.easyplay.no/api_clients/token \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "YOUR_CLIENT_ID",
    "clientSecret": "YOUR_CLIENT_SECRET"
  }'

The response contains a JWT that is valid for 15 minutes. Request a new one when it expires.

2. Call an endpoint

Use the token as a Bearer token to fetch a club you have access to. External clients use the routes that end in /external:

curl https://api.easyplay.no/clubs/id/YOUR_CLUB_ID/external \
  -H "Authorization: Bearer YOUR_TOKEN"

If the token is valid and your client has a scope for that club, you get a 200 with the club's id, name, username and logo. Otherwise the API returns 403 Forbidden.

Next steps