# Entur Contracts client API

**Canonical:** https://apis.io/apis/entur/entur-contracts-client-api/  
**Provider:** Entur — https://apis.io/providers/entur/  
**Base URL:** https://api.entur.io/cleos-reporting  
**Documentation:** https://developer.entur.no/apis/clearing-reports

Entur Contracts client API is one of 199 APIs that [Entur](https://apis.io/providers/entur/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 120 JSON Schema definitions. Tagged areas include Contracts client. The published artifact set on APIs.io includes an OpenAPI specification and 120 JSON Schemas.

API for handling loyalty program contracts.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| POST | `/customers/v2/benefits/contracts/claim-personnel-ticket` | Claims a personnel ticket directly |
| POST | `/customers/v2/benefits/contracts/validate-consumptions` | Validate contract consumption |
| GET | `/customers/v2/benefits/contracts` | Return all contracts with possible filtering |
| GET | `/customers/v2/benefits/contracts/{externalRef}/by-external-ref` | Get contracts by external ref |
| GET | `/customers/v2/benefits/contract-consumers/{customerNumber}/contracts` | Get all valid contracts by customer number |

## Machine-readable artifacts (121)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/openapi/entur-contracts-client-api-openapi.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-partner-dataset-rpt-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-partner-dataset-download-job-dto-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-partner-settlement-import-dto-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-partner-settlement-import-response-dto-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-given-consent-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-consent-crm-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-consent-base-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-given-consent-bulk-update-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-given-consent-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-consent-base-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-customer-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-temporary-customer-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-customer-post-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-customer-put-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-ecard-ownership-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-temporary-customer-post-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-result-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-quota-request-v1-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-quota-configuration-response-v1-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-quota-response-v1-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-reservation-response-v1-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-quota-configuration-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-multi-stock-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-search-geo-location-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-search-authority-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-search-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-search-trip-pattern-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-collection-info-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-customer-input-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-search-offer-input-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-subscriber-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-extend-expiry-time-input-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-update-traveller-input-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-order-note-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-order-note-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-page-of-order-note-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-order-line-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-order-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/entur/refs/heads/main/json-schema/entur-fee-request-schema.json
- …and 81 more, listed in full on the page.

## Other Entur APIs (12)

- [Journey Planner (GraphQL)](https://apis.io/apis/entur/journey-planner-v3/)
- [Vehicle Positions (GraphQL)](https://apis.io/apis/entur/vehicles-v2/)
- [Mobility (GraphQL)](https://apis.io/apis/entur/mobility-v2/)
- [Entur Admin/bucket Invalidation API](https://apis.io/apis/entur/entur-admin-bucket-invalidation-api/)
- [Entur Admin/cache API](https://apis.io/apis/entur/entur-admin-cache-api/)
- [Entur Amount Of Price Unit Products API](https://apis.io/apis/entur/entur-amount-of-price-unit-products-api/)
- [Entur API Documentation API](https://apis.io/apis/entur/entur-api-documentation-api/)
- [Entur Authentication admin API](https://apis.io/apis/entur/entur-authentication-admin-api/)
- [Entur Authentication API](https://apis.io/apis/entur/entur-authentication-api/)
- [Entur Authtoken Public Key API](https://apis.io/apis/entur/entur-authtokenpublickey-api/)
- [Entur Autocomplete API](https://apis.io/apis/entur/entur-autocomplete-api/)
- [Entur Availability Conditions API](https://apis.io/apis/entur/entur-availability-conditions-api/)

## Tags

Contracts client

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/entur/entur-contracts-client-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/entur/.