Klar API

Klar API as documented publicly: 10 operations. Contract generated from the documentation by API Evangelist (2026-11-10); not the provider's own document.

GitHub OpenAPI

Operations 10

POST /12.2022/orders/validate POST /12.2022/orders/validate #
GET /cogs/status Über diesen Endpunkt kannst du einige Kennzahlen abfragen, z.B. die Gesamtzahl der übermittelten Erstattungen total, die Anzahl der in der letzten Übermittlung gesendeten COGS last #
GET /logistics-costs/state GET /logistics-costs/state #
GET /logistics-costs/status GET /logistics-costs/status #
POST /orders/json Der wichtigste Endpoint ist POST /orders/json. Das ist der „Master"-Endpoint für alle Bestelldaten. #
GET /orders/status This endpoint allows to query a few metrics, like the total amount of orders submitted `total` (only counting orders submitted on or after the 14.03.2023), the amount of orders sub #
GET /public/attribution Dieser Endpunkt ruft die Daten des Attribution Reports basierend auf den angegebenen Filtern ab. #
POST /public/auth/token Liefert einen kurzlebigen Access Token für die API-Authentifizierung. #
GET /refunds/status This endpoint allows to query a few metrics, like the total amount of refunds submitted total, the amount of refunds submitted in the last submission lastBatchCount and the time of #
GET /transaction-costs/status GET /transaction-costs/status #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/getklar-com:getklar-com-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

getklar-com-openapi-generated.yml Raw ↑
openapi: 3.1.0
info:
  title: Klar API
  version: '2026-11-10'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-10: 10 operation(s) read from 15 public documentation page(s) (each
    operation names its page in x-source). This is not the provider''s published contract; Klar has published no machine-readable contract that
    the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 1
    documentation: 9
    pages-with-code: 2
    pages-read: 15
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-10'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://help.getklar.com/en/articles/9345573-orders-api-endpoint.md
  - https://help.getklar.com/en/articles/9345948-refunds-api-endpoint.md
  - https://help.getklar.com/en/articles/9346148-logistics-costs-api-endpoint.md
  - https://help.getklar.com/de/articles/12943188-transaction-costs-api-endpoint.md
  - https://help.getklar.com/en/articles/12943188-transaction-costs-api-endpoint.md
  - https://help.getklar.com/de/articles/9346189-cogs-api-endpunkt.md
  - https://help.getklar.com/en/articles/9345493-api-authentication.md
  - https://help.getklar.com/de/articles/9345573-orders-api-endpunkt.md
  - https://help.getklar.com/de/articles/9345948-refunds-api-endpunkt.md
  - https://help.getklar.com/de/articles/9345493-api-authentifizierung.md
  - https://help.getklar.com/de/articles/9346148-logistics-costs-api-endpunkt.md
  - https://help.getklar.com/de/articles/13687045-attribution-api-dokumentation.md
  - https://help.getklar.com/en/articles/13687045-attribution-api-documentation.md
  - https://help.getklar.com/de/articles/14721213-developer-guide-verbindung-zur-klar-restful-api.md
  - https://help.getklar.com/en/articles/14721213-developer-guide-connecting-to-the-klar-restful-api.md
servers:
- url: https://open-api.getklar.com
paths:
  /12.2022/orders/validate:
    post:
      operationId: post_12_2022_orders_validate
      tags:
      - '12'
      summary: POST /12.2022/orders/validate
      x-source: https://help.getklar.com/en/articles/9345493-api-authentication.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -X POST  --data "@/path/to/filename"  -H "Authorization: Bearer <token>"  -H "Accept: application/json"  -H "Content-Type:
          application/json"  "https://open-api.durchsichtig.xyz/12.2022/orders/validate"

          ```'
  /cogs/status:
    get:
      operationId: get_cogs_status
      tags:
      - Cogs
      summary: Über diesen Endpunkt kannst du einige Kennzahlen abfragen, z.B. die Gesamtzahl der übermittelten Erstattungen total, die Anzahl
        der in der letzten Übermittlung gesendeten COGS lastBatchCount sowie den
      x-source: https://help.getklar.com/de/articles/9346189-cogs-api-endpunkt.md
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCogsStatusResponse'
      x-evidence:
        kind: documentation
  /logistics-costs/state:
    get:
      operationId: get_logistics_costs_state
      tags:
      - Logistics Costs
      summary: GET /logistics-costs/state
      description: This endpoint allows to query a few metrics, like the total amount of refunds submitted `total,` the amount of submitted in
        the last submission `lastBatchCount` and the time of the last successful / failed submission `lastSuccess` / `lastFailure`.
      x-source: https://help.getklar.com/en/articles/9346148-logistics-costs-api-endpoint.md
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetLogisticsCostsStateResponse'
      x-evidence:
        kind: documentation
  /logistics-costs/status:
    get:
      operationId: get_logistics_costs_status
      tags:
      - Logistics Costs
      summary: GET /logistics-costs/status
      x-source: https://help.getklar.com/de/articles/9346148-logistics-costs-api-endpunkt.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /orders/json:
    post:
      operationId: post_orders_json
      tags:
      - Orders
      summary: Der wichtigste Endpoint ist POST /orders/json. Das ist der „Master"-Endpoint für alle Bestelldaten.
      x-source: https://help.getklar.com/de/articles/14721213-developer-guide-verbindung-zur-klar-restful-api.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /orders/status:
    get:
      operationId: get_orders_status
      tags:
      - Orders
      summary: This endpoint allows to query a few metrics, like the total amount of orders submitted `total` (only counting orders submitted
        on or after the 14.03.2023), the amount of orders submitted in the last s
      x-source: https://help.getklar.com/en/articles/9345573-orders-api-endpoint.md
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetOrdersStatusResponse'
      x-evidence:
        kind: documentation
  /public/attribution:
    get:
      operationId: get_public_attribution
      tags:
      - Public
      summary: Dieser Endpunkt ruft die Daten des Attribution Reports basierend auf den angegebenen Filtern ab.
      x-source: https://help.getklar.com/de/articles/13687045-attribution-api-dokumentation.md
      parameters:
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
        description: Bearer <accessToken> (der im Schritt Access Token abrufen erhaltene Token).
      - name: startDate
        in: query
        required: true
        schema:
          type: string
        description: 'Das Startdatum für den Report (Format: yyyy-mm-dd).'
      - name: endDate
        in: query
        required: true
        schema:
          type: string
        description: 'Das Enddatum für den Report (Format: yyyy-mm-dd, muss innerhalb von 31 Tagen ab startDate liegen, wird ausgeschlossen).'
      - name: metric
        in: query
        required: false
        schema:
          type: string
        description: Attributionsmodell (first_touch, last_touch, data_driven, linear, any_click, any_click_unique, u_shape, time_decay, marketing_mix).
      - name: window
        in: query
        required: false
        schema:
          type: string
        description: Attributionsfenster (unlimited, 1_day, 7_day, 28_day).
      - name: date_breakdown
        in: query
        required: false
        schema:
          type: string
        description: Datumstyp für Gruppierung (order, touch).
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPublicAttributionResponse'
      x-evidence:
        kind: documentation
  /public/auth/token:
    post:
      operationId: post_public_auth_token
      tags:
      - Public
      summary: Liefert einen kurzlebigen Access Token für die API-Authentifizierung.
      x-source: https://help.getklar.com/de/articles/13687045-attribution-api-dokumentation.md
      parameters:
      - name: token
        in: header
        required: true
        schema:
          type: string
        description: Der statische Refresh Token des Users.
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostPublicAuthTokenResponse'
      x-evidence:
        kind: documentation
  /refunds/status:
    get:
      operationId: get_refunds_status
      tags:
      - Refunds
      summary: This endpoint allows to query a few metrics, like the total amount of refunds submitted total, the amount of refunds submitted
        in the last submission lastBatchCount and the time of the last successful
      x-source: https://help.getklar.com/en/articles/9345948-refunds-api-endpoint.md
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetRefundsStatusResponse'
      x-evidence:
        kind: documentation
  /transaction-costs/status:
    get:
      operationId: get_transaction_costs_status
      tags:
      - Transaction Costs
      summary: GET /transaction-costs/status
      x-source: https://help.getklar.com/de/articles/12943188-transaction-costs-api-endpoint.md
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTransactionCostsStatusResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetCogsStatusResponse:
      type: object
      properties:
        total:
          type: string
          description: Gesamtzahl der übermittelten Erstattungen
        lastBatchCount:
          type: string
          description: Anzahl der in der letzten Übermittlung gesendeten COGS
        lastSuccess:
          type: string
          description: Zeitpunkt der letzten erfolgreichen Übermittlung
        lastFailure:
          type: string
          description: Zeitpunkt der letzten fehlgeschlagenen Übermittlung
    GetLogisticsCostsStateResponse:
      type: object
      properties:
        total:
          type: string
          description: total amount of refunds submitted
        lastBatchCount:
          type: string
          description: amount of submitted in the last submission
        lastSuccess:
          type: string
          description: time of the last successful submission
        lastFailure:
          type: string
          description: time of the last failed submission
    GetOrdersStatusResponse:
      type: object
      properties:
        total:
          type: string
          description: total amount of orders submitted
        lastBatchCount:
          type: string
          description: amount of orders submitted in the last submission
        lastSuccess:
          type: string
          description: time of the last successful submission
        lastFailure:
          type: string
          description: time of the last failed submission
    GetPublicAttributionResponse:
      type: object
      properties:
        channelName:
          type: string
        date:
          type: string
        campaignName:
          type: string
        campaignId:
          type: string
        adGroupName:
          type: string
        adGroupId:
          type: integer
        adName:
          type: string
        adId:
          type: integer
        orders:
          type: number
        nc:
          type: number
        rc:
          type: number
        netRevenue:
          type: number
        grossRevenue:
          type: number
        cost:
          type: number
        clicks:
          type: integer
        impressions:
          type: integer
        cm1:
          type: number
        cm2:
          type: number
        clv_30:
          type: number
        clv_60:
          type: number
        clv_90:
          type: number
        acm2:
          type: number
        ncGrossRevenue:
          type: number
        rcGrossRevenue:
          type: number
        ncNetRevenue:
          type: number
        rcNetRevenue:
          type: number
    PostPublicAuthTokenResponse:
      type: object
      properties:
        accessToken:
          type: string
          description: Der temporäre Access Token.
        expiresIn:
          type: integer
          description: Ablaufzeit in Millisekunden (300000).
    GetRefundsStatusResponse:
      type: object
      properties:
        total:
          type: string
          description: total amount of refunds submitted
        lastBatchCount:
          type: string
          description: amount of refunds submitted in the last submission
        lastSuccess:
          type: string
          description: time of the last successful submission
        lastFailure:
          type: string
          description: time of the last failed submission
    GetTransactionCostsStatusResponse:
      type: object
      properties:
        total:
          type: string
        lastBatchCount:
          type: string
        lastSuccess:
          type: string
          description: ISO‑8601 timestamp of the last successful transmission
        lastFailure:
          type: string
          description: ISO‑8601 timestamp of the last failed transmission
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: '12'
- name: Cogs
- name: Logistics Costs
- name: Orders
- name: Public
- name: Refunds
- name: Transaction Costs