> ## Documentation Index
> Fetch the complete documentation index at: https://docs.energy.nlead.ch/llms.txt
> Use this file to discover all available pages before exploring further.

# Every phone number and address of the partners' PARTINs, once

> Per partner the newest datasheet it sent the BKV: each phone number,
e-mail address and fax number once, with the Bereiche (contact
functions) and units it is named for, the datasheet's date, transport
and reference, and how many older ones it replaced.



## OpenAPI

````yaml /setup/internal-openapi.json get /v1/process/market-partners/partin-kontakte
openapi: 3.1.0
info:
  title: n:lead Scheduling Bridge — Internal API
  version: 0.4.0
  description: >-
    Internal API of the n:lead scheduling bridge: the process endpoints that
    drive the day-ahead pipeline (aggregate, publish the open position, submit
    schedules, generate forecasts, orchestrate), the operator console endpoints,
    and the read-only operator-app endpoints under /v1/mobile. The process and
    console endpoints require the process API key, /v1/mobile a device key of
    the mobile scope; not for customer use.
servers:
  - url: https://{host}
    description: Deployed service
    variables:
      host:
        default: api.energy.nlead.ch
        description: >-
          The service hostname - n:lead provides it (see the Base URL on the API
          introduction page)
  - url: http://localhost:8000
    description: Local development
security: []
paths:
  /v1/process/market-partners/partin-kontakte:
    get:
      tags:
        - Marktpartner
      summary: Every phone number and address of the partners' PARTINs, once
      description: |-
        Per partner the newest datasheet it sent the BKV: each phone number,
        e-mail address and fax number once, with the Bereiche (contact
        functions) and units it is named for, the datasheet's date, transport
        and reference, and how many older ones it replaced.
      operationId: get_partin_kontakte_v1_process_market_partners_partin_kontakte_get
      parameters:
        - name: mp_id
          in: query
          required: false
          schema:
            anyOf:
              - items:
                  type: string
                type: array
              - type: 'null'
            description: Only these partners (repeat the parameter)
            title: Mp Id
          description: Only these partners (repeat the parameter)
        - name: lookback_days
          in: query
          required: false
          schema:
            type: integer
            maximum: 730
            minimum: 1
            default: 180
            title: Lookback Days
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartinKontakteResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
        - HTTPBearer: []
components:
  schemas:
    PartinKontakteResponse:
      properties:
        stand:
          type: string
          title: Stand
        lookback_days:
          type: integer
          title: Lookback Days
        partner:
          additionalProperties:
            $ref: '#/components/schemas/PartinKontaktUebersicht'
          type: object
          title: Partner
          description: By MP-ID; partners without a datasheet are absent
      type: object
      required:
        - stand
        - lookback_days
        - partner
      title: PartinKontakteResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    PartinKontaktUebersicht:
      properties:
        datum:
          type: string
          title: Datum
          description: When the datasheet arrived
        via:
          type: string
          title: Via
          description: '`as4` or `email` (a mailed attachment)'
        referenz:
          type: string
          title: Referenz
        version:
          type: string
          title: Version
        pruefidentifikator:
          type: string
          title: Pruefidentifikator
        firma:
          type: string
          title: Firma
          default: ''
        aeltere:
          type: integer
          title: Aeltere
          description: Older datasheets it replaced in the window
        telefone:
          items:
            $ref: '#/components/schemas/PartinKontaktWert'
          type: array
          title: Telefone
        emails:
          items:
            $ref: '#/components/schemas/PartinKontaktWert'
          type: array
          title: Emails
        faxe:
          items:
            $ref: '#/components/schemas/PartinKontaktWert'
          type: array
          title: Faxe
      type: object
      required:
        - datum
        - via
        - referenz
        - version
        - pruefidentifikator
        - aeltere
        - telefone
        - emails
        - faxe
      title: PartinKontaktUebersicht
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    PartinKontaktWert:
      properties:
        wert:
          type: string
          title: Wert
          description: The number or address, as the datasheet has it
        bereiche:
          items:
            $ref: '#/components/schemas/PartinBereich'
          type: array
          title: Bereiche
          description: Every function it is named for - each number once
        einheiten:
          items:
            type: string
          type: array
          title: Einheiten
          description: The units (CTA) named with it
      type: object
      required:
        - wert
        - bereiche
        - einheiten
      title: PartinKontaktWert
    PartinBereich:
      properties:
        code:
          type: string
          title: Code
          description: NAD qualifier of the contact block, e.g. Z21
        bezeichnung:
          type: string
          title: Bezeichnung
          description: What PARTIN AHB 1.1 calls the desk
      type: object
      required:
        - code
        - bezeichnung
      title: PartinBereich
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
    HTTPBearer:
      type: http
      description: OIDC access token (Auth0 M2M)
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.