KPN Rest Track And Trace Controller API

openapi: 3.2.0
info:
  description: "MobileServicesManagement APIs\n\n   ---\n     \n ## [Source view](https://app.swaggerhub.com/apis/kpn/MobileServicesManagement-KPN/)<br/>\n [Documentation view](https://app.swaggerhub.com/apis/kpn/MobileServicesManagement-KPN/)\n \n ---\n \n ## [KPN Developer](https://developer.kpn.com/)<br/>\n [Getting Started](https://developer.kpn.com/getting-started)\n \n\n ---"
  version: v11
  title: MobileServicesManagement-KPN Rest Track And Trace Controller API
  termsOfService: https://developer.kpn.com/legal
  contact:
    name: API Support
    email: api_developer@kpn.com
    url: https://developer.kpn.com/support
servers:
- url: https://api-prd.kpn.com/mobile/kpn/mobileservices
tags:
- name: rest-track-and-trace-controller
  description: Rest Track And Trace Controller
paths:
  /track-and-trace/orders:
    get:
      tags:
      - rest-track-and-trace-controller
      summary: Get order list
      description: <strong>Required privileges</strong> (one of the following):</strong><ul><li>privileges_orders_track_and_trace</li><li>privileges_orders_authorization</li></ul>
      operationId: getOrdersUsingGET
      parameters:
      - name: currentUserOrdersOnly
        in: query
        required: false
        x-example: false
        schema:
          type: boolean
          default: false
      - name: from
        in: query
        description: Pagination parameter - start from (included). The elements are counted from 0. Default value is 0.
        required: false
        x-example: 0
        schema:
          type: integer
          format: int32
      - name: order
        in: query
        required: false
        schema:
          type: string
          enum:
          - ASC
          - DESC
      - name: patterns
        in: query
        required: false
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      - name: sortBy
        in: query
        required: false
        schema:
          type: string
          enum:
          - CREATION_DATE
          - STATUS
          - KPN_REFERENCE
          - ORDERED_FOR
          - CUSTOMER_REFERENCE
      - name: status
        in: query
        required: true
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
            enum:
            - IN_PROGRESS
            - UNAUTHORIZED
            - NEW
            - CLOSED
            - CANCELED
            - REJECTED
            - DRAFT
            - THIRD_PARTY
            - HOLD_CUSTOMER
            - WAITING
      - name: to
        in: query
        description: Pagination parameter - end element (exluded). Default value is 20.
        required: false
        x-example: 20
        schema:
          type: integer
          format: int32
      - name: withRequiredActionFirst
        in: query
        required: false
        schema:
          type: boolean
          default: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/PagedResult_Order_'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Service Unavailable
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - OAuth2: []
  /track-and-trace/orders/{id}:
    get:
      tags:
      - rest-track-and-trace-controller
      summary: Get order details
      description: <strong>Required privileges</strong> (one of the following):</strong><ul><li>privileges_orders_track_and_trace</li><li>privileges_orders_authorization</li></ul>
      operationId: getOrderDetailsUsingGET
      parameters:
      - name: id
        in: path
        description: id
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/OrderDetails1'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Service Unavailable
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - OAuth2: []
  /track-and-trace/orders/{id}/cancel:
    post:
      tags:
      - rest-track-and-trace-controller
      summary: Cancel order
      description: <strong>Required privileges</strong> (one of the following):</strong><ul><li>privileges_orders_track_and_trace</li><li>privileges_orders_authorization</li></ul>
      operationId: cancelOrderUsingPOST
      parameters:
      - name: id
        in: path
        description: id
        required: true
        schema:
          type: integer
          format: int64
      - name: note
        in: query
        description: note
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Service Unavailable
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - OAuth2: []
  /track-and-trace/orders/{id}/hardware:
    get:
      tags:
      - rest-track-and-trace-controller
      summary: Get list of hardware which was ordered in the order with the given id
      description: <strong>Required privileges</strong> (one of the following):</strong><ul><li>privileges_orders_track_and_trace</li><li>privileges_orders_authorization</li></ul>
      operationId: getHardwareForOrderUsingGET
      parameters:
      - name: id
        in: path
        description: id
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Hardware'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Service Unavailable
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - OAuth2: []
  /track-and-trace/orders/{id}/porting-data:
    post:
      tags:
      - rest-track-and-trace-controller
      summary: Change port in date or customer number
      description: "Endpoint allows to change both : customer number and wish date in one request or change only one parameter. \nThere are several possibility to set data:\n| newWishDate | asap | customerNumber | result                              |\n|-------------|--------|----------------|-------------------------------------|\n| date        | false  | null           | change only wish date               |\n| null        | true   | null           | change only wish date to ASAP       |\n| null        | true   | number         | change customer number and wishDate |\n| date        | false  | number         | change customer number and wishDate |\n| date        | true   |   *            | validation error                    |\n| null        | false  | null           | validation error                    |\n\n<strong>Required privileges</strong> (one of the following):</strong><ul><li>privileges_orders_track_and_trace</li><li>privileges_orders_authorization</li></ul>"
      operationId: changePortingDataUsingPOST
      parameters:
      - name: id
        in: path
        description: id
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: OK
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Service Unavailable
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - OAuth2: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChangePortingData'
        description: data
        required: true
  /track-and-trace/orders/{id}/pretty:
    get:
      tags:
      - rest-track-and-trace-controller
      summary: Get order details in pretty form
      description: <strong>Required privileges</strong> (one of the following):</strong><ul><li>privileges_orders_track_and_trace</li><li>privileges_orders_authorization</li></ul>
      operationId: getPrettyOrderDetailsUsingGET
      parameters:
      - name: id
        in: path
        description: id
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/PrettyOrderDetails'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Service Unavailable
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - OAuth2: []
  /track-and-trace/overview:
    get:
      tags:
      - rest-track-and-trace-controller
      summary: Get number of orders grouped by orders type
      description: <strong>Required privileges</strong> (one of the following):</strong><ul><li>privileges_orders_track_and_trace</li><li>privileges_orders_authorization</li></ul>
      operationId: getOverviewUsingGET
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
                additionalProperties:
                  type: integer
                  format: int64
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Service Unavailable
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - OAuth2: []
  /track-and-trace/returned-hardware-service-requests:
    get:
      tags:
      - rest-track-and-trace-controller
      summary: Get return hardware service requests list
      description: <strong>Required privileges</strong> (one of the following):</strong><ul><li>privileges_orders_track_and_trace</li><li>privileges_orders_authorization</li></ul>
      operationId: getReturnedHardwareServiceRequestUsingGET
      parameters:
      - name: currentUserOrdersOnly
        in: query
        required: false
        x-example: false
        schema:
          type: boolean
          default: false
      - name: from
        in: query
        description: Pagination parameter - start from (included). The elements are counted from 0. Default value is 0.
        required: false
        x-example: 0
        schema:
          type: integer
          format: int32
      - name: order
        in: query
        required: false
        schema:
          type: string
          enum:
          - ASC
          - DESC
      - name: patterns
        in: query
        required: false
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      - name: status
        in: query
        required: true
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
            enum:
            - IN_PROGRESS
            - UNAUTHORIZED
            - NEW
            - CLOSED
            - CANCELED
            - REJECTED
            - DRAFT
            - THIRD_PARTY
            - HOLD_CUSTOMER
            - WAITING
      - name: to
        in: query
        description: Pagination parameter - end element (exluded). Default value is 20.
        required: false
        x-example: 20
        schema:
          type: integer
          format: int32
      - name: withRequiredActionFirst
        in: query
        required: false
        schema:
          type: boolean
          default: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/PagedResult_ReturnedHardwareServiceRequests_'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Service Unavailable
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - OAuth2: []
  /track-and-trace/service-requests:
    get:
      tags:
      - rest-track-and-trace-controller
      summary: Get service requests list
      description: <strong>Required privileges</strong> (one of the following):</strong><ul><li>privileges_orders_track_and_trace</li><li>privileges_orders_authorization</li></ul>
      operationId: getServiceRequestsUsingGET
      parameters:
      - name: Content-Language
        in: header
        description: Content-Language
        required: false
        schema:
          type: string
      - name: currentUserOrdersOnly
        in: query
        required: false
        x-example: false
        schema:
          type: boolean
          default: false
      - name: from
        in: query
        description: Pagination parameter - start from (included). The elements are counted from 0. Default value is 0.
        required: false
        x-example: 0
        schema:
          type: integer
          format: int32
      - name: order
        in: query
        required: false
        schema:
          type: string
          enum:
          - ASC
          - DESC
      - name: patterns
        in: query
        required: false
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      - name: sortBy
        in: query
        required: false
        schema:
          type: string
          enum:
          - CREATION_DATE
          - STATUS
          - KPN_REFERENCE
          - REQUEST_BY
          - REQUEST_FOR
          - TYPE
          - CUSTOMER_REFERENCE
      - name: status
        in: query
        required: true
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
            enum:
            - IN_PROGRESS
            - UNAUTHORIZED
            - NEW
            - CLOSED
            - CANCELED
            - REJECTED
            - DRAFT
            - THIRD_PARTY
            - HOLD_CUSTOMER
            - WAITING
      - name: to
        in: query
        description: Pagination parameter - end element (exluded). Default value is 20.
        required: false
        x-example: 20
        schema:
          type: integer
          format: int32
      - name: withRequiredActionFirst
        in: query
        required: false
        schema:
          type: boolean
          default: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/PagedResult_ServiceRequest_'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Service Unavailable
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - OAuth2: []
  /track-and-trace/service-requests/{id}:
    get:
      tags:
      - rest-track-and-trace-controller
      summary: Get service requests details
      description: "The possible keys of `attributes` map in response object:<div style='max-height: 400px; overflow: auto; width: 100%'>\n<dl>\n<dt><b>Attribute name</b></dt><dd><b>Meaning</b></dd>\n<dt>login</dt><dd>Login</dd>\n<dt>roles</dt><dd>Roles</dd>\n<dt>firstName</dt><dd>First name</dd>\n<dt>lastName</dt><dd>Last name</dd>\n<dt>surnamePrefix</dt><dd>Surname prefix</dd>\n<dt>email</dt><dd>E-mail</dd>\n<dt>dateOfBirth</dt><dd>Date of birth</dd>\n<dt>vip</dt><dd>VIP</dd>\n<dt>employeeNumber</dt><dd>Employee number</dd>\n<dt>gender</dt><dd>Gender</dd>\n<dt>salutation</dt><dd>Salutation</dd>\n<dt>preferredLanguage</dt><dd>Preferred language</dd>\n<dt>comments</dt><dd>Comments</dd>\n<dt>accesspointNameMSISDN</dt><dd>Mobile number</dd>\n<dt>accesspointNameSIM</dt><dd>SIM card number</dd>\n<dt>accesspointNameIMSI</dt><dd>IMSI</dd>\n<dt>IMEI</dt><dd>IMEI</dd>\n<dt>Hanset_IMEI_number</dt><dd>IMEI</dd>\n<dt>accesspointNameFixedNumber</dt><dd>Fixed Number</dd>\n<dt>activeTo</dt><dd>Active to</dd>\n<dt>contractName</dt><dd>Subscription or device name</dd>\n<dt>totalOnetimePrice</dt><dd>One time price</dd>\n<dt>totalRecurrentPrice</dt><dd>Recurring price</dd>\n<dt>deferredPrice</dt><dd>Deferred price</dd>\n<dt>newUiccId</dt><dd>New SIM card number</dd>\n<dt>movedGroupName</dt><dd>Moved account</dd>\n<dt>subscriberAccountId</dt><dd>Old location</dd>\n<dt>destinationAccount</dt><dd>New location</dd>\n<dt>selectedDuoUiccid</dt><dd>Selected Duo SIM card number</dd>\n<dt>projectId</dt><dd>Project ID</dd>\n<dt>new_fixed_number</dt><dd>New fixed number</dd>\n<dt>new_desk_number</dt><dd>New extension</dd>\n<dt>oldUserGroupName</dt><dd>Previous user group</dd>\n<dt>newUserGroupName</dt><dd>New user group</dd>\n<dt>vpnName</dt><dd>VPN name</dd>\n<dt>deskNumber</dt><dd>Extension</dd>\n<dt>accesspointNameDeskNumber</dt><dd>Extension</dd>\n<dt>mobileAddress</dt><dd>Mobile number</dd>\n<dt>enterpriseName</dt><dd>Enterprise name</dd>\n<dt>enterpriseID</dt><dd>Enterprise ID</dd>\n<dt>mobilityGroupName</dt><dd>Fixed-Mobile PBX name</dd>\n<dt>userGroupName</dt><dd>User group</dd>\n<dt>enterpriseUserGroup</dt><dd>User group</dd>\n<dt>initialUserPrincipalName</dt><dd>User Principal Name</dd>\n<dt>sipAccountName</dt><dd>SIP account name</dd>\n<dt>accessInstanceAttributeinitialUserPrincipalName</dt><dd>User Principal Name</dd>\n<dt>accesspointNameQueuePhoneNumber</dt><dd>Queue phone number</dd>\n<dt>accesspointNameSipAccountName</dt><dd>SIP account name</dd>\n<dt>subscriptionAmount</dt><dd>New subscription amount</dd>\n<dt>contract_contact_name</dt><dd>Contract contact person (name)</dd>\n<dt>contract_contact_phone</dt><dd>Contract contact person (phone)</dd>\n<dt>contract_contact_mail</dt><dd>Contract contact person (mail)</dd>\n<dt>financial_contact_name</dt><dd>Financial contact person (name)</dd>\n<dt>financial_contact_phone</dt><dd>Financial contact person (phone)</dd>\n<dt>financial_contact_mail</dt><dd>Financial contact person (mail)</dd>\n<dt>technical_contact_name</dt><dd>Technical contact Person (name)</dd>\n<dt>technical_contact_phone</dt><dd>Technical contact Person (phone)</dd>\n<dt>technical_contact_mail</dt><dd>Technical contact Person (mail)</dd>\n<dt>deviceOption</dt><dd>Device option</dd>\n<dt>deviceType_label</dt><dd>Device type</dd>\n<dt>macAddress</dt><dd>Mac address</dd>\n<dt>deviceName</dt><dd>Device name</dd>\n<dt>sacGroupAccountId_label</dt><dd>Location account</dd>\n<dt>groupId</dt><dd>Location</dd>\n<dt>vGroupMovingToID</dt><dd>New location</dd>\n<dt>pbxName</dt><dd>PBX</dd>\n<dt>groupCitemId_label</dt><dd>Group</dd>\n<dt>Fixed</dt><dd>Alternate fixed number</dd>\n<dt>DeskNumber</dt><dd>Alternate extension</dd>\n<dt>billing_retention_period</dt><dd>Financial data retention period (months)</dd>\n<dt>managedGroupName</dt><dd>Authorized for</dd>\n<dt>subscriptionType</dt><dd>Subscription type</dd>\n<dt>CurrentNetworkOperator</dt><dd>Current network operator</dd>\n<dt>CurrentServiceProvider</dt><dd>Current service provider</dd>\n<dt>Customer_name_at_current_provider</dt><dd>Customer name at current provider</dd>\n<dt>Current_contract_number</dt><dd>Customer number at current provider</dd>\n<dt>UIccId</dt><dd>Current SIM card number</dd>\n<dt>Initials</dt><dd>Initials</dd>\n<dt>FamilyNamePrefix</dt><dd>Family name prefix</dd>\n<dt>FamilyName</dt><dd>Family name</dd>\n<dt>delivery_TT_id</dt><dd>Delivery Track&trace ID</dd>\n<dt>IsAppleDEP</dt><dd>Apple DEP</dd>\n<dt>IsSamsungKNOX</dt><dd>Samsung KNOX</dd>\n<dt>keepCurrentSim</dt><dd>Keep existing SIM card</dd>\n<dt>Note</dt><dd>Note</dd>\n<dt>Porting_wish_date</dt><dd>Preferred transition date</dd>\n<dt>returnReason</dt><dd>Reason for return</dd>\n<dt>returnRemarks</dt><dd>Remarks</dd>\n<dt>companyName</dt><dd>Company name</dd>\n<dt>companyNamePronounciation</dt><dd>Comapny name pronounciation</dd>\n<dt>businessVoiceMailMessageText</dt><dd>Chosen business voicemail message</dd>\n</dl>\n<div>\n<style type=\"text/css\">  dl {\n    display: flex;\n    flex-flow: row wrap;\n  }\n  dt {\n    flex-basis: 20%;\n    text-align: right;\n  }\n  dd {\n    flex-basis: 70%;\n    flex-grow: 1;\n  }\n</style>\n\n<strong>Required privileges</strong> (one of the following):</strong><ul><li>privileges_orders_track_and_trace</li><li>privileges_orders_authorization</li></ul>"
      operationId: getServiceRequestDetailsUsingGET
      parameters:
      - name: id
        in: path
        description: id
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ServiceRequestDetails'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Service Unavailable
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - OAuth2: []
  /track-and-trace/service-requests/{id}/attachments/{attachmentId}:
    get:
      tags:
      - rest-track-and-trace-controller
      summary: Get attachment with given id and serviceRequestId
      description: <strong>Required privileges</strong> (one of the following):</strong><ul><li>privileges_orders_track_and_trace</li><li>privileges_orders_authorization</li></ul>
      operationId: getAttachmentUsingGET
      parameters:
      - name: attachmentId
        in: path
        description: attachmentId
        required: true
        schema:
          type: integer
          format: int64
      - name: id
        in: path
        description: id
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Serializable'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
   

# --- truncated at 32 KB (60 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/kpn/refs/heads/main/openapi/kpn-rest-track-and-trace-controller-api-openapi.yml