Skip to main content

Get Started

All OpenHive API calls require a valid JWT bearer token issued by the Identity Provider (IDP). This page walks you through getting a token and making your first authenticated request.

Step 1 — Get an access token​

Call the IDP POST /token endpoint with your client credentials:

curl -X POST https://idp.openhive.eu/token \
  -d grant_type=client_credentials \
  -d client_id=<your-client-id> \
  -d client_secret=<your-client-secret>

Response:

{
  "token_type": "Bearer",
  "expires_in": 3600,
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..."
}

The token is valid for 1 hour. Cache it and renew it before expiry rather than fetching a new one on every request.

Client credentials

Your client_id and client_secret are provisioned by OpenHive. Contact your account manager if you don't have them yet.

Step 2 — Call a service​

Pass the access_token as a Bearer token in the Authorization header on every request.

Fetch the available payment methods for your account:

curl https://payment.openhive.eu/api/payment-methods \
  -H "Authorization: Bearer <access_token>"

Next steps​

  • Explore each service's API reference in the Services section of the sidebar.
  • See Authentication → POST /token for the full endpoint reference including error codes.