Skip to main content

Available Accesses

Overview​

The Accesses endpoint provides authenticated users with with providers and services the user has access to, where a provider represents the data owner (e.g. your company) and a service represents the data type (e.g., sales data).

The combination of service_id and provider_id is used to access specific data and metadata from the API. Users can query this endpoint to retrieve a list of services and providers they have access to.

GET /v1/access​

Retrieves the access list for the authenticated user.

  • Method: GET
  • URL: https://api.kinver.no/v1/access
  • Authentication: Required (Token-based). See Authentication and Authorization
  • Description: This endpoint returns a list of services and providers the authenticated user has access to, based on their token.

Example​

GET /v1/access
Host: api.kinver.no
kauth: <token>

Response​

  • Content-Type: application/json
  • Returns a JSON object containing the list of accesses.

Example Response​

{
  "data": [
    {
      "provider_id": 123,
      "service_id": 456,
      "service_name": "Example Service"
    }
  ]
}

Usage in Subsequent Requests​

After retrieving the list of accessible services and providers, users can utilize the service_id and provider_id to make further requests to the Available Columns and Export Data endpoints.