Eagle Doc API

openapi: 3.1.0
info:
  title: Eagle Doc API
  version: '2026-10-27'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-27: 23 operation(s) read from 10 public documentation page(s) (each
    operation names its page in x-source). This is not the provider''s published contract; Eagle Doc has published no machine-readable contract
    that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 14
    documentation: 9
    pages-with-code: 10
    pages-read: 10
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-27'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://www.eagle-doc.com/de/documentation/business-api
  - https://www.eagle-doc.com/en/documentation/business-api
  - https://www.eagle-doc.com/de/documentation/business-api/clients
  - https://www.eagle-doc.com/en/documentation/business-api/clients
  - https://www.eagle-doc.com/de/documentation/business-api/rag
  - https://www.eagle-doc.com/en/documentation/business-api/rag
  - https://www.eagle-doc.com/de/documentation/business-api/usage
  - https://www.eagle-doc.com/en/documentation/business-api/usage
  - https://www.eagle-doc.com/de/documentation/business-api/processing
  - https://www.eagle-doc.com/en/documentation/business-api/processing
servers:
- url: https://de.eagle-doc.com
paths:
  /api/anydoc/v1/processing:
    get:
      operationId: get_api_anydoc_v1_processing
      tags:
      - Api
      summary: GET /api/anydoc/v1/processing
      x-source: https://www.eagle-doc.com/de/documentation/business-api/processing
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl --location 'https://de.eagle-doc.com/api/anydoc/v1/processing'  --header 'api-key: APIB-your-business-key'  --header 'x-sub-business-ref:\
          \ A-1023'  --form 'file=@\"document.pdf\"' \n import requests\nresp = requests.post(\n \"https://de.eagle-doc.com/api/anydoc/v1/processing\"\
          ,\n headers={\n \"api-key\": \"APIB-your-business-key\",\n \"x-sub-business-ref\": \"A-1023\", # your own client number\n },\n files={\"\
          file"
    post:
      operationId: post_api_anydoc_v1_processing
      tags:
      - Api
      summary: POST /api/anydoc/v1/processing
      x-source: https://www.eagle-doc.com/de/documentation/business-api/processing
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: javascript
        snippet: "fetch(\"https://de.eagle-doc.com/api/anydoc/v1/processing\", {\n method: \"POST\",\n headers: {\n \"api-key\": \"APIB-your-business-key\"\
          ,\n \"x-sub-business-ref\": \"A-1023\", //your own client number\n },\n body: form,\n})"
  /api/business/{businessid}/sub-businesses:
    get:
      operationId: get_api_business_businessid_sub_businesses
      tags:
      - Api
      summary: GET /api/business/{businessId}/sub-businesses
      x-source: https://www.eagle-doc.com/de/documentation/business-api/clients
      parameters:
      - name: businessid
        in: path
        required: true
        schema:
          type: string
      - name: api-key
        in: header
        required: true
        schema:
          type: string
        description: Real-user token with role MEMBER or higher (listing is available to any member). APIB‑… business keys are rejected.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiBusinessBusinessidSubBusinessesResponse'
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_business_businessid_sub_businesses
      tags:
      - Api
      summary: POST /api/business/{businessId}/sub-businesses
      x-source: https://www.eagle-doc.com/de/documentation/business-api/clients
      parameters:
      - name: businessid
        in: path
        required: true
        schema:
          type: string
      - name: api-key
        in: header
        required: true
        schema:
          type: string
        description: 'Real-user token: a personal API‑… key with role ADMIN or higher. APIB‑… business keys are rejected.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiBusinessBusinessidSubBusinessesRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiBusinessBusinessidSubBusinessesResponse'
      x-evidence:
        kind: documentation
  /api/business/{businessid}/sub-businesses/{subbusinessid}:
    delete:
      operationId: delete_api_business_businessid_sub_businesses_subbusinessid
      tags:
      - Api
      summary: DELETE /api/business/{businessId}/sub-businesses/{subBusinessId}
      x-source: https://www.eagle-doc.com/de/documentation/business-api/clients
      parameters:
      - name: businessid
        in: path
        required: true
        schema:
          type: string
      - name: subbusinessid
        in: path
        required: true
        schema:
          type: string
      - name: api-key
        in: header
        required: true
        schema:
          type: string
        description: Real-user token with role ADMIN or higher. APIB‑… business keys are rejected.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    patch:
      operationId: patch_api_business_businessid_sub_businesses_subbusinessid
      tags:
      - Api
      summary: PATCH /api/business/{businessId}/sub-businesses/{subBusinessId}
      x-source: https://www.eagle-doc.com/de/documentation/business-api/clients
      parameters:
      - name: businessid
        in: path
        required: true
        schema:
          type: string
      - name: subbusinessid
        in: path
        required: true
        schema:
          type: string
      - name: api-key
        in: header
        required: true
        schema:
          type: string
        description: Real-user token with role ADMIN or higher. APIB‑… business keys are rejected.
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchApiBusinessBusinessidSubBusinessesSubbusinessidRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PatchApiBusinessBusinessidSubBusinessesSubbusinessidResponse'
      x-evidence:
        kind: documentation
  /api/business/{businessid}/usage/breakdown:
    get:
      operationId: get_api_business_businessid_usage_breakdown
      tags:
      - Api
      summary: Aufschlüsselung pro Kunde
      description: Returns an array of per‑client usage rows for the requested period.
      x-source: https://www.eagle-doc.com/de/documentation/business-api/usage
      parameters:
      - name: businessid
        in: path
        required: true
        schema:
          type: string
      - name: period
        in: query
        required: false
        schema:
          type: string
        description: current for the ongoing billing month, or a past month as YYYY-MM.
      - name: api-key
        in: header
        required: true
        schema:
          type: string
        description: 'A real‑user token: a personal API‑… key (or dashboard session) with role MEMBER or higher. APIB‑… keys are rejected.'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiBusinessBusinessidUsageBreakdownResponse'
      x-evidence:
        kind: documentation
  /api/business/{businessid}/usage/current:
    get:
      operationId: get_api_business_businessid_usage_current
      tags:
      - Api
      summary: GET /api/business/{businessId}/usage/current provides current usage for the whole business
      description: Provides the current usage for the entire business, using the same structure as the personal Usage‑API.
      x-source: https://www.eagle-doc.com/de/documentation/business-api/usage
      parameters:
      - name: businessid
        in: path
        required: true
        schema:
          type: string
      - name: api-key
        in: header
        required: true
        schema:
          type: string
        description: 'A real‑user token: a personal API‑… key (or dashboard session) with role MEMBER or higher.'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiBusinessBusinessidUsageCurrentResponse'
      x-evidence:
        kind: documentation
  /api/doc/v1/split:
    get:
      operationId: get_api_doc_v1_split
      tags:
      - Api
      summary: GET /api/doc/v1/split
      x-source: https://www.eagle-doc.com/de/documentation/business-api/processing
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl --location 'https://de.eagle-doc.com/api/doc/v1/split'  --header 'api-key: APIB-your-business-key'  --header 'x-sub-business-ref:\
          \ A-1023'  --form 'file=@\"document.pdf\"' \n import requests\nresp = requests.post(\n \"https://de.eagle-doc.com/api/doc/v1/split\"\
          ,\n headers={\n \"api-key\": \"APIB-your-business-key\",\n \"x-sub-business-ref\": \"A-1023\", # your own client number\n },\n files={\"\
          file\": open(\"documen"
    post:
      operationId: post_api_doc_v1_split
      tags:
      - Api
      summary: POST /api/doc/v1/split
      x-source: https://www.eagle-doc.com/de/documentation/business-api/processing
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: javascript
        snippet: "fetch(\"https://de.eagle-doc.com/api/doc/v1/split\", {\n method: \"POST\",\n headers: {\n \"api-key\": \"APIB-your-business-key\"\
          ,\n \"x-sub-business-ref\": \"A-1023\", //your own client number\n },\n body: form,\n})"
  /api/docu/learning:
    get:
      operationId: get_api_docu_learning
      tags:
      - Api
      summary: GET /api/docu/learning
      x-source: https://www.eagle-doc.com/de/documentation/business-api/rag
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiDocuLearningResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl --location 'https://de.eagle-doc.com/api/docu/learning'  --header 'api-key: APIB-your-business-key'  --header 'x-sub-business-ref:\
          \ A-1023'  --form 'file=@\"invoice.pdf\"'  --form 'original=@\"original.json\"'  --form 'corrected=@\"corrected.json\"' \n import requests\n\
          resp = requests.post(\n \"https://de.eagle-doc.com/api/docu/learning\",\n headers={\n \"api-key\": \"APIB-your-business-key\",\n \"\
          x-sub-business"
    post:
      operationId: post_api_docu_learning
      tags:
      - Api
      summary: POST /api/docu/learning
      x-source: https://www.eagle-doc.com/de/documentation/business-api/rag
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiDocuLearningResponse'
      x-evidence:
        kind: code-example
        language: javascript
        snippet: "fetch(\"https://de.eagle-doc.com/api/docu/learning\", {\n method: \"POST\",\n headers: {\n \"api-key\": \"APIB-your-business-key\"\
          ,\n \"x-sub-business-ref\": \"A-1023\", //attribute this example to a client\n },\n body: form,\n})"
  /api/docu/learning/instructions:
    get:
      operationId: get_api_docu_learning_instructions
      tags:
      - Api
      summary: GET /api/docu/learning/instructions
      x-source: https://www.eagle-doc.com/de/documentation/business-api/rag
      parameters:
      - name: instructions
        in: query
        required: false
        schema:
          type: string
      - name: overwrite
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl --location 'https://de.eagle-doc.com/api/docu/learning/instructions?instructions=from%20text%20%27paid%20by%20Feb%2002%2C%202025%27%2C%20get%20InvoiceDueDate%3A%20%272025-02-02%27&overwrite=false'\
          \  --header 'api-key: APIB-your-business-key'  --header 'x-sub-business-ref: A-1023'  --form 'corrected=@\"corrected.json\"' \n import\
          \ requests\nresp = requests.post(\n \"https://de.eagle-doc.com/api/docu/l"
    post:
      operationId: post_api_docu_learning_instructions
      tags:
      - Api
      summary: POST /api/docu/learning/instructions
      x-source: https://www.eagle-doc.com/de/documentation/business-api/rag
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: python
        snippet: "requests.post(\n \"https://de.eagle-doc.com/api/docu/learning/instructions\",\n params={\n \"instructions\": \"from text 'paid\
          \ by Feb 02, 2025', get InvoiceDueDate: '2025-02-02'\",\n \"overwrite\": \"false\",\n },\n headers={\n \"api-key\": \"APIB-your-business-key\"\
          ,\n \"x-sub-business-ref\": \"A-1023\", # learn for this client only\n },\n files={\"corrected\": open(\"corrected.json\", \"rb\")"
  /api/finance/v1/processing:
    get:
      operationId: get_api_finance_v1_processing
      tags:
      - Api
      summary: GET /api/finance/v1/processing
      x-source: https://www.eagle-doc.com/de/documentation/business-api/processing
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl --location 'https://de.eagle-doc.com/api/finance/v1/processing'  --header 'api-key: APIB-your-business-key'  --header 'x-sub-business-ref:\
          \ A-1023'  --form 'file=@\"document.pdf\"' \n import requests\nresp = requests.post(\n \"https://de.eagle-doc.com/api/finance/v1/processing\"\
          ,\n headers={\n \"api-key\": \"APIB-your-business-key\",\n \"x-sub-business-ref\": \"A-1023\", # your own client number\n },\n files={\"\
          fi"
    post:
      operationId: post_api_finance_v1_processing
      tags:
      - Api
      summary: POST /api/finance/v1/processing
      x-source: https://www.eagle-doc.com/de/documentation/business-api/processing
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: javascript
        snippet: "fetch(\"https://de.eagle-doc.com/api/finance/v1/processing\", {\n method: \"POST\",\n headers: {\n \"api-key\": \"APIB-your-business-key\"\
          ,\n \"x-sub-business-ref\": \"A-1023\", //your own client number\n },\n body: form,\n})"
  /api/invoice/v1/processing:
    get:
      operationId: get_api_invoice_v1_processing
      tags:
      - Api
      summary: GET /api/invoice/v1/processing
      x-source: https://www.eagle-doc.com/de/documentation/business-api/processing
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl --location 'https://de.eagle-doc.com/api/invoice/v1/processing'  --header 'api-key: APIB-your-business-key'  --header 'x-sub-business-ref:\
          \ A-1023'  --form 'file=@\"invoice.pdf\"' \n import requests\nresp = requests.post(\n \"https://de.eagle-doc.com/api/invoice/v1/processing\"\
          ,\n headers={\n \"api-key\": \"APIB-your-business-key\",\n \"x-sub-business-ref\": \"A-1023\", # your own client number\n },\n files={\"\
          fil"
    post:
      operationId: post_api_invoice_v1_processing
      tags:
      - Api
      summary: POST /api/invoice/v1/processing
      x-source: https://www.eagle-doc.com/de/documentation/business-api/processing
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: javascript
        snippet: "fetch(\"https://de.eagle-doc.com/api/invoice/v1/processing\", {\n method: \"POST\",\n headers: {\n \"api-key\": \"APIB-your-business-key\"\
          ,\n \"x-sub-business-ref\": \"A-1023\", //your own client number\n },\n body: form,\n})"
  /api/receipt/v3/processing:
    get:
      operationId: get_api_receipt_v3_processing
      tags:
      - Api
      summary: GET /api/receipt/v3/processing
      x-source: https://www.eagle-doc.com/de/documentation/business-api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl --location 'https://de.eagle-doc.com/api/receipt/v3/processing'  --header 'api-key: APIB-your-business-key'  --header 'x-sub-business-ref:\
          \ A-1023'  --form 'file=@\"receipt.jpeg\"' \n import requests\nresp = requests.post(\n \"https://de.eagle-doc.com/api/receipt/v3/processing\"\
          ,\n headers={\n \"api-key\": \"APIB-your-business-key\",\n \"x-sub-business-ref\": \"A-1023\", # your own client number\n },\n files={\"\
          fi"
    post:
      operationId: post_api_receipt_v3_processing
      tags:
      - Api
      summary: POST /api/receipt/v3/processing
      x-source: https://www.eagle-doc.com/de/documentation/business-api
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: javascript
        snippet: "fetch(\"https://de.eagle-doc.com/api/receipt/v3/processing\", {\n method: \"POST\",\n headers: {\n \"api-key\": \"APIB-your-business-key\"\
          ,\n \"x-sub-business-ref\": \"A-1023\", //your own client number\n },\n body: form,\n})"
  /api/usage/v1/current:
    get:
      operationId: get_api_usage_v1_current
      tags:
      - Api
      summary: Rufen Sie GET /api/usage/v1/current mit dem Business-Schlüssel für das gebündelte Kontingent auf.
      description: Check current usage and quota using the Business API key.
      x-source: https://www.eagle-doc.com/de/documentation/business-api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/usage/v1/logs:
    get:
      operationId: get_api_usage_v1_logs
      tags:
      - Api
      summary: GET /api/usage/v1/logs liefert ein Protokoll pro Anfrage
      description: Returns a log of each request with the same field structure as the personal Usage‑API.
      x-source: https://www.eagle-doc.com/de/documentation/business-api/usage
      parameters:
      - name: api-key
        in: header
        required: true
        schema:
          type: string
        description: A business API key (APIB-…). The response is rolled up across all of the business’s clients.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiUsageV1LogsResponse'
      x-evidence:
        kind: documentation
  /api/usage/v1/monthly:
    get:
      operationId: get_api_usage_v1_monthly
      tags:
      - Api
      summary: GET /api/usage/v1/monthly liefert vergangene Kontingent‑Zeiträume
      description: Provides past quota periods with the same field structure as the personal Usage‑API.
      x-source: https://www.eagle-doc.com/de/documentation/business-api/usage
      parameters:
      - name: api-key
        in: header
        required: true
        schema:
          type: string
        description: A business API key (APIB-…). The response is rolled up across all of the business’s clients.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiUsageV1MonthlyResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetApiBusinessBusinessidSubBusinessesResponse:
      type: object
      properties:
        id:
          type: string
          description: Sub‑business identifier.
        name:
          type: string
          description: Name of the sub‑business.
        description:
          type: string
          description: Description of the sub‑business.
        parentBusinessId:
          type: string
          description: ID of the parent business.
        billingMode:
          type: string
          description: Billing mode.
        wrapsPersonalAccount:
          type: string
          description: Whether it wraps a personal account.
        externalClientRef:
          type: string
          description: External client reference.
        createdAt:
          type: string
          description: Creation timestamp.
        updatedAt:
          type: string
          description: Last update timestamp.
    PostApiBusinessBusinessidSubBusinessesRequest:
      type: object
      properties:
        name:
          type: string
          description: Name of the sub‑business.
        description:
          type: string
          description: Optional description.
        externalClientRef:
          type: string
          description: Optional external client reference.
      required:
      - name
    PostApiBusinessBusinessidSubBusinessesResponse:
      type: object
      properties:
        id:
          type: string
          description: Sub‑business identifier.
        name:
          type: string
          description: Name of the sub‑business.
        description:
          type: string
          description: Description of the sub‑business.
        parentBusinessId:
          type: string
          description: ID of the parent business.
        billingMode:
          type: string
          description: Billing mode.
        wrapsPersonalAccount:
          type: string
          description: Whether it wraps a personal account.
        externalClientRef:
          type: string
          description: External client reference.
        createdAt:
          type: string
          description: Creation timestamp.
        updatedAt:
          type: string
          description: Last update timestamp.
    PatchApiBusinessBusinessidSubBusinessesSubbusinessidRequest:
      type: object
      properties:
        name:
          type: string
          description: New name.
        description:
          type: string
          description: New description.
        externalClientRef:
          type: string
          description: New external client reference.
    PatchApiBusinessBusinessidSubBusinessesSubbusinessidResponse:
      type: object
      properties:
        id:
          type: string
          description: Sub‑business identifier.
        name:
          type: string
          description: Name of the sub‑business.
        description:
          type: string
          description: Description of the sub‑business.
        parentBusinessId:
          type: string
          description: ID of the parent business.
        billingMode:
          type: string
          description: Billing mode.
        wrapsPersonalAccount:
          type: string
          description: Whether it wraps a personal account.
        externalClientRef:
          type: string
          description: External client reference.
        createdAt:
          type: string
          description: Creation timestamp.
        updatedAt:
          type: string
          description: Last update timestamp.
    GetApiBusinessBusinessidUsageBreakdownResponse:
      type: object
      properties:
        subBusinessId:
          type: string
          description: The client’s id. An empty string marks the main business’s own usage.
        subBusinessName:
          type: string
          description: The client’s display name. Deleted clients appear as (deleted sub-business).
        externalClientRef:
          type: string
          description: Your own client reference (the x-sub-business-ref you sent), if any.
        pages:
          type: string
          description: Pages processed for this client (may be fractional).
        pageCredits:
          type: string
          description: Billed page credits for this client.
        requests:
          type: string
          description: Number of requests made for this client.
    GetApiBusinessBusinessidUsageCurrentResponse:
      type: object
      properties:
        currentMonth:
          type: string
          description: The billing month in YYYY-MM format.
        contractQuota:
          type: string
          description: Pages included by the business contract.
        quotaUsed:
          type: string
          description: Pages processed so far this month across all clients.
        overUsageAllowed:
          type: string
          description: Whether usage may exceed contractQuota.
        hardLimit:
          type: string
          description: A ceiling above which no more pages are processed (may be null).
        overUsage:
          type: string
          description: Pages beyond the contract quota (quotaUsed - contractQuota).
        pricePerPageOverUsage:
          type: string
          description: Agreed price per over-usage page.
        overUsageCost:
          type: string
          description: overUsage × pricePerPageOverUsage.
    GetApiDocuLearningResponse:
      type: object
      properties:
        message:
          type: string
    PostApiDocuLearningResponse:
      type: object
      properties:
        message:
          type: string
    GetApiUsageV1LogsResponse:
      type: object
      properties:
        currentMonth:
          type: string
          description: The billing month in YYYY-MM format.
        contractQuota:
          type: string
          description: Pages included by the business contract.
        quotaUsed:
          type: string
          description: Pages processed so far this month across all clients.
        overUsageAllowed:
          type: string
          description: Whether usage may exceed contractQuota.
        hardLimit:
          type: string
          description: A ceiling above which no more pages are processed (may be null).
        overUsage:
          type: string
          description: Pages beyond the contract quota (quotaUsed - contractQuota).
        pricePerPageOverUsage:
          type: string
          description: Agreed price per over-usage page.
        overUsageCost:
          type: string
          description: overUsage × pricePerPageOverUsage.
    GetApiUsageV1MonthlyResponse:
      type: object
      properties:
        currentMonth:
          type: string
          description: The billing month in YYYY-MM format.
        contractQuota:
          type: string
          description: Pages included by the business contract.
        quotaUsed:
          type: string
          description: Pages processed so far this month across all clients.
        overUsageAllowed:
          type: string
          description: Whether usage may exceed contractQuota.
        hardLimit:
          type: string
          description: A ceiling above which no more pages are processed (may be null).
        overUsage:
          type: string
          description: Pages beyond the contract quota (quotaUsed - contractQuota).
        pricePerPageOverUsage:
          type: string
          description: Agreed price per over-usage page.
        overUsageCost:
          type: string
          description: overUsage × pricePerPageOverUsage.
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: api-key
security:
- apiKey: []
tags:
- name: Api