openapi: 3.0.0
info:
  version: '-'
  title: 'Unified Data Repository Service API file for subscription data'
  description: 'The API version is defined in 3GPP TS 29.504'
  
externalDocs:
  description: 3GPP TS 29.505 V15.2.0; 5G System; Usage of the Unified Data Repository services for Subscription Data; Stage 3
  url: 'http://www.3gpp.org/ftp/Specs/archive/29_series/29.505/'

paths:

  /subscription-data/{ueId}/authentication-data/authentication-subscription:
    get:
      summary: Retrieves the authentication subscription data of a UE
      operationId: QueryAuthSubsData
      tags:
        - Authentication Data (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: supported-features
          in: query
          description: Supported Features
          schema:
             $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
      responses:
        '200':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthenticationSubscription'
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'                
    patch:
      summary: modify the authentication subscription data of a UE
      operationId: ModifyAuthentication
      tags:
        - Authentication Data (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
      requestBody:
        content:
          application/json-patch+json:
            schema:
              type: array
              items:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/PatchItem'
        required: true
      responses:
        '204':
          description: Expected response to a valid request
        '403':
          description: modification is rejected
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'

  /subscription-data/{ueId}/authentication-data/authentication-status: 
    put:
      summary: To store the Authentication Status data of a UE 
      operationId: CreateAuthenticationStatus
      tags:
        - Authentication Status (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
      requestBody:
        content:
          application/json:
            schema:
              $ref: 'TS29503_Nudm_UEAU.yaml#/components/schemas/AuthEvent'
      responses:  
        '204':
          description: Upon success, an empty response body shall be returned
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'

    get:
      summary: Retrieves the Authentication Status of a UE
      operationId: QueryAuthenticationStatus
      tags:
        - AuthEvent (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: fields
          in: query
          description: attributes to be retrieved
          required: false
          schema:
            type: array
            items:
              type: string
            minItems: 1
          style: form
          explode: false
        - name: supportedFeatures
          description: Supported Features
          in: query
          schema:
             $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
      responses:
        '200':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                $ref: 'TS29503_Nudm_UEAU.yaml#/components/schemas/AuthEvent'
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'

  /subscription-data/{ueId}/ue-update-confirmation-data/sor-data:
    put:
      summary: To store the SoR acknowledgement information of a UE 
      operationId: CreateAuthenticationSoR
      tags:
        - Authentication SoR (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: supported-features 
          in: query
          description: Supported Features
          schema:
             $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SorData'
      responses:  
        '204':
          description: Expected response to a valid request
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
    get:
      summary: Retrieves the SoR acknowledgement information of a UE
      operationId: QueryAuthSoR
      tags:
        - Authentication SoR (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: supportedFeatures
          in: query
          description: Supported Features
          schema:
             $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
      responses:
        '200':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SorData'
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'

  /subscription-data/{ueId}/{servingPlmnId}/provisioned-data:
    get:
      summary: Retrieve multiple provisioned data sets of a UE
      operationId: QueryProvisionedData
      tags:
        - Provisioned Data (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: servingPlmnId
          in: path
          description: PLMN ID
          required: true
          schema:
            $ref: '#/components/schemas/VarPlmnId'
        - name: dataset-names
          in: query
          description: List of dataset names
          schema:
            $ref: '#/components/schemas/DatasetNames'
      responses:
        '200':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProvisionedDataSets'
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'

                
  /subscription-data/{ueId}/{servingPlmnId}/provisioned-data/am-data:
    get:
      summary: Retrieves the access and mobility subscription data of a UE
      operationId: QueryAmData
      tags:
        - Access And Mobility Subscription Data (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: servingPlmnId
          in: path
          description: PLMN ID
          required: true
          schema:
            $ref: '#/components/schemas/VarPlmnId'
        - name: fields
          in: query
          description: attributes to be retrieved
          required: false
          schema:
            type: array
            items:
              type: string
            minItems: 1
          style: form
          explode: false
        - name: supported-features
          in: query
          description: Supported Features
          schema:
             $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
        - name: If-None-Match
          in: header
          description: Validator for conditional requests, as described in RFC 7232, 3.2
          schema:
            type: string
        - name: If-Modified-Since
          in: header
          description: Validator for conditional requests, as described in RFC 7232, 3.3
          schema:
            type: string
      responses:
        '200':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessAndMobilitySubscriptionData'
          headers:
            Cache-Control:
              description: Cache-Control containing max-age, as described in RFC 7234, 5.2
              schema:
                type: string
            ETag:
              description: Entity Tag, containing a strong validator, as described in RFC 7232, 2.3
              schema:
                type: string
            Last-Modified:
              description: Timestamp for last modification of the resource, as described in RFC 7232, 2.2
              schema:
                type: string
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
                
  /subscription-data/{ueId}/{servingPlmnId}/provisioned-data/smf-selection-subscription-data:
    get:
      summary: Retrieves the SMF selection subscription data of a UE
      operationId: QuerySmfSelectData
      tags:
        - SMF Selection Subscription Data (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: servingPlmnId
          in: path
          description: PLMN ID
          required: true
          schema:
            $ref: '#/components/schemas/VarPlmnId'
        - name: fields
          in: query
          description: attributes to be retrieved
          required: false
          schema:
            type: array
            items:
              type: string
            minItems: 1
          style: form
          explode: false
        - name: supported-features
          in: query
          description: Supported Features
          schema:
             $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
        - name: If-None-Match
          in: header
          description: Validator for conditional requests, as described in RFC 7232, 3.2
          schema:
            type: string
        - name: If-Modified-Since
          in: header
          description: Validator for conditional requests, as described in RFC 7232, 3.3
          schema:
            type: string
      responses:
        '200':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SmfSelectionSubscriptionData'
          headers:
            Cache-Control:
              description: Cache-Control containing max-age, as described in RFC 7234, 5.2
              schema:
                type: string
            ETag:
              description: Entity Tag, containing a strong validator, as described in RFC 7232, 2.3
              schema:
                type: string
            Last-Modified:
              description: Timestamp for last modification of the resource, as described in RFC 7232, 2.2
              schema:
                type: string
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
                
  /subscription-data/{ueId}/{servingPlmnId}/provisioned-data/sm-data:
    get:
      summary: Retrieves the Session Management subscription data of a UE
      operationId: QuerySmData
      tags:
        - Session Management Subscription Data
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: servingPlmnId
          in: path
          description: PLMN ID
          required: true
          schema:
            $ref: '#/components/schemas/VarPlmnId'
        - name: single-nssai
          in: query
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VarSnssai'
          description: single NSSAI
          required: false
        - name: dnn
          in: query
          description: DNN
          required: false
          schema:
            $ref: '#/components/schemas/Dnn'
        - name: fields
          in: query
          description: attributes to be retrieved
          required: false
          schema:
            type: array
            items:
              type: string
            minItems: 1
          style: form
          explode: false
        - name: supported-features
          in: query
          description: Supported Features
          schema:
             $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
        - name: If-None-Match
          in: header
          description: Validator for conditional requests, as described in RFC 7232, 3.2
          schema:
            type: string
        - name: If-Modified-Since
          in: header
          description: Validator for conditional requests, as described in RFC 7232, 3.3
          schema:
            type: string
      responses:
        '200':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SessionManagementSubscriptionData'
                minItems: 1
          headers:
            Cache-Control:
              description: Cache-Control containing max-age, as described in RFC 7234, 5.2
              schema:
                type: string
            ETag:
              description: Entity Tag, containing a strong validator, as described in RFC 7232, 2.3
              schema:
                type: string
            Last-Modified:
              description: Timestamp for last modification of the resource, as described in RFC 7232, 2.2
              schema:
                type: string
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
                
  /subscription-data/{ueId}/context-data/amf-3gpp-access:
    get:
      summary: Retrieves the AMF context data of a UE using 3gpp access
      operationId: QueryAmfContext3gpp
      tags:
        - AMF 3GPP Access Registration (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: fields
          in: query
          description: attributes to be retrieved
          required: false
          schema:
            type: array
            items:
              type: string
            minItems: 1
          style: form
          explode: false
        - name: supported-features
          in: query
          description: Supported Features
          schema:
             $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
      responses:  
        '200':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Amf3GppAccessRegistration'
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
    put:
      summary: To store the AMF context data of a UE using 3gpp access in the UDR
      operationId: CreateAmfContext3gpp
      tags:
        - AMF 3GPP Access Registration (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Amf3GppAccessRegistration'
      responses:  
        '204':
          description: Upon success, an empty response body shall be returned
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
    patch:
      summary: To modify the AMF context data of a UE using 3gpp access in the UDR
      operationId: AmfContext3gpp
      tags:
        - AMF 3GPP Access Registration (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
      requestBody:
        content:
          application/json-patch+json:
            schema:
              type: array
              items:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/PatchItem'
        required: true
      responses:
        '204':
          description: Expected response to a valid request
        '403':
          description: modification is rejected
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
                
  /subscription-data/{ueId}/context-data/amf-non-3gpp-access:
    get:
      summary: Retrieves the AMF context data of a UE using non-3gpp access
      operationId: QueryAmfContextNon3gpp
      tags:
        - AMF Non-3GPP Access Registration (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: fields
          in: query
          description: attributes to be retrieved
          required: false
          schema:
            type: array
            items:
              type: string
            minItems: 1
          style: form
          explode: false
        - name: supported-features
          in: query
          description: Supported Features
          schema:
             $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
      responses:  
        '200':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AmfNon3GppAccessRegistration'
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
    put:
      summary: To store the AMF context data of a UE using non-3gpp access in the UDR
      operationId: CreateAmfContextNon3gpp
      tags:
        - AMF Non-3GPP Access Registration (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AmfNon3GppAccessRegistration'
      responses:  
        '204':
          description: Upon success, an empty response body shall be returned
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
    patch:
      summary: To modify the AMF context data of a UE using non 3gpp access in the UDR
      operationId: AmfContextNon3gpp
      tags:
        - AMF Non-3GPP Access Registration (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
      requestBody:
        content:
          application/json-patch+json:
            schema:
              type: array
              items:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/PatchItem'
        required: true
      responses:
        '204':
          description: Expected response to a valid request
        '403':
          description: modification is rejected
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
                
  /subscription-data/{ueId}/context-data/smf-registrations:
    get:
      summary: Retrieves the SMF registration list of a UE
      operationId: QuerySmfRegList
      tags:
        - SMF Registrations (Collection)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: supported-features
          in: query
          description: Supported Features
          schema:
             $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
      responses:
        '200':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SmfRegList'
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
                
  /subscription-data/{ueId}/context-data/smf-registrations/{pduSessionId}:
    get:
      summary: Retrieves the individual SMF registration of a UE 
      operationId: QuerySmfRegistration
      tags:
        - SMF Registration (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: pduSessionId
          in: path
          description: PDU session id
          required: true
          schema:
            type: string
        - name: fields
          in: query
          description: attributes to be retrieved
          required: false
          schema:
            type: array
            items:
              type: string
            minItems: 1
          style: form
          explode: false
        - name: supported-features
          in: query
          description: Supported Features
          schema:
             $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
      responses:  
        '200':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SmfRegistration'
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
    put:
      summary: To create an individual SMF context data of a UE in the UDR
      operationId: CreateSmfContextNon3gpp
      tags:
        - SMF Registration (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: pduSessionId
          in: path
          description: PDU session id
          required: true
          schema:
            type: integer
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SmfRegistration'
      responses:  
        '201':
          description: Upon success, a response body containing a representation of the created Individual SmfRegistration resource shall be returned
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
          headers:
            Location:
              description: 'Contains the URI of the newly created resource, according to the structure: {apiRoot}/nsmf-pdusession/v1/sm-contexts/{smContextRef}/subscription-data/{ueId}/context-data/smf-registrations/{pduSessionId}'
              required: true
              schema:
                type: string
    delete:
      summary: To remove an individual SMF context data of a UE the UDR
      operationId: DeleteSmfContext
      tags:
        - SMF Registration (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: pduSessionId
          in: path
          description: PDU session id
          required: true
          schema:
            type: string
      responses:  
        '204':
          description: Upon success, an empty response body shall be returned.
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
                
  /subscription-data/{ueId}/operator-specific-data:
    get:
      summary: Retrieves the operator specific data of a UE 
      operationId: QueryOperSpecData
      tags:
        - Operator-Specific Data Container (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: fields
          in: query
          description: attributes to be retrieved
          required: false
          schema:
            type: array
            items:
              type: string
            minItems: 1
          style: form
          explode: false
        - name: supported-features
          in: query
          description: Supported Features
          schema:
             $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
        - name: If-None-Match
          in: header
          description: Validator for conditional requests, as described in RFC 7232, 3.2
          schema:
            type: string
        - name: If-Modified-Since
          in: header
          description: Validator for conditional requests, as described in RFC 7232, 3.3
          schema:
            type: string
      responses:  
        '200':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OperatorSpecificDataContainer'
          headers:
            Cache-Control:
              description: Cache-Control containing max-age, as described in RFC 7234, 5.2
              schema:
                type: string
            ETag:
              description: Entity Tag, containing a strong validator, as described in RFC 7232, 2.3
              schema:
                type: string
            Last-Modified:
              description: Timestamp for last modification of the resource, as described in RFC 7232, 2.2
              schema:
                type: string
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
    patch:
      summary: To modify operator specific data of a UE
      operationId: AmfContext3gpp
      tags:
        - Operator-Specific Data Container (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
      requestBody:
        content:
          application/json-patch+json:
            schema:
              type: array
              items:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/PatchItem'
        required: true
      responses:
        '204':
          description: Expected response to a valid request
        '403':
          description: modification is rejected
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
                
  /subscription-data/{ueId}/context-data/smsf-3gpp-access:
    put:
      summary: Create the SMSF context data of a UE via 3GPP access 
      operationId: CreateSmsfContext3gpp
      tags:
        - SMSF 3GPP Registration (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SmsfRegistration'
      responses:  
        '204':
          description: Upon success, an empty response body shall be returned
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
    delete:
      summary: To remove the SMSF context data of a UE via 3GPP access 
      operationId: DeleteSmsfContext3gpp
      tags:
        - SMSF 3GPP Registration (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
      responses:  
        '204':
          description: Upon success, an empty response body shall be returned
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
    get:
      summary: Retrieves the SMSF context data of a UE using 3gpp access
      operationId: QuerySmsfContext3gpp
      tags:
        - SMSF 3GPP Registration (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: fields
          in: query
          description: attributes to be retrieved
          required: false
          schema:
            type: array
            items:
              type: string
            minItems: 1
          style: form
          explode: false
        - name: supported-features
          in: query
          description: Supported Features
          schema:
             $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
      responses:  
        '200':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SmsfRegistration'
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
                
  /subscription-data/{ueId}/context-data/smsf-non-3gpp-access:
    put:
      summary: Create the SMSF context data of a UE via non-3GPP access 
      operationId: CreateSmsfContextNon3gpp
      tags:
        - SMSF Non-3GPP Registration (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SmsfRegistration'
      responses:  
        '204':
          description: Upon success, an empty response body shall be returned
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
    delete:
      summary: To remove the SMSF context data of a UE via non-3GPP access 
      operationId: DeleteSmsfContextNon3gpp
      tags:
        - SMSF Non-3GPP Registration (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
      responses:  
        '204':
          description: Upon success, an empty response body shall be returned
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
    get:
      summary: Retrieves the SMSF context data of a UE using non-3gpp access
      operationId: QuerySmsfContextNon3gpp
      tags:
        - SMSF Non-3GPP Registration (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: fields
          in: query
          description: attributes to be retrieved
          required: false
          schema:
            type: array
            items:
              type: string
            minItems: 1
          style: form
          explode: false
        - name: supported-features
          in: query
          description: Supported Features
          schema:
             $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
      responses:  
        '200':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SmsfRegistration'
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
                
  /subscription-data/{ueId}/{servingPlmnId}/provisioned-data/sms-mng-data:
    get:
      summary: Retrieves the SMS management subscription data of a UE
      operationId: QuerySmsMngData
      tags:
        - SMS Management Subscription Data (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: servingPlmnId
          in: path
          description: PLMN ID
          required: true
          schema:
            $ref: '#/components/schemas/VarPlmnId'
        - name: supported-features
          in: query
          description: Supported Features
          schema:
             $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
        - name: If-None-Match
          in: header
          description: Validator for conditional requests, as described in RFC 7232, 3.2
          schema:
            type: string
        - name: If-Modified-Since
          in: header
          description: Validator for conditional requests, as described in RFC 7232, 3.3
          schema:
            type: string
      responses:
        '200':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SmsManagementSubscriptionData'
          headers:
            Cache-Control:
              description: Cache-Control containing max-age, as described in RFC 7234, 5.2
              schema:
                type: string
            ETag:
              description: Entity Tag, containing a strong validator, as described in RFC 7232, 2.3
              schema:
                type: string
            Last-Modified:
              description: Timestamp for last modification of the resource, as described in RFC 7232, 2.2
              schema:
                type: string
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
                
  /subscription-data/{ueId}/{servingPlmnId}/provisioned-data/sms-data:
    get:
      summary: Retrieves the SMS subscription data of a UE
      operationId: QuerySmsData
      tags:
        - SMS Subscription Data (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: servingPlmnId
          in: path
          description: PLMN ID
          required: true
          schema:
            $ref: '#/components/schemas/VarPlmnId'
        - name: supported-features
          in: query
          description: Supported Features
          schema:
             $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
        - name: If-None-Match
          in: header
          description: Validator for conditional requests, as described in RFC 7232, 3.2
          schema:
            type: string
        - name: If-Modified-Since
          in: header
          description: Validator for conditional requests, as described in RFC 7232, 3.3
          schema:
            type: string
      responses:
        '200':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SmsSubscriptionData'
          headers:
            Cache-Control:
              description: Cache-Control containing max-age, as described in RFC 7234, 5.2
              schema:
                type: string
            ETag:
              description: Entity Tag, containing a strong validator, as described in RFC 7232, 2.3
              schema:
                type: string
            Last-Modified:
              description: Timestamp for last modification of the resource, as described in RFC 7232, 2.2
              schema:
                type: string
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
                
  /subscription-data/{ueId}/pp-data:
    get:
      summary: Read the profile of a given UE
      operationId: GetppData
      tags:
      - Parameter Provision (Document)
      parameters:
        - name: ueId
          in: path
          description: pp data for a UE
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: supported-features
          in: query
          description: Supported Features
          schema:
             $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
        - name: If-None-Match
          in: header
          description: Validator for conditional requests, as described in RFC 7232, 3.2
          schema:
            type: string
        - name: If-Modified-Since
          in: header
          description: Validator for conditional requests, as described in RFC 7232, 3.3
          schema:
            type: string
      responses:
        '200':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PpData'
          headers:
            Cache-Control:
              description: Cache-Control containing max-age, as described in RFC 7234, 5.2
              schema:
                type: string
            ETag:
              description: Entity Tag, containing a strong validator, as described in RFC 7232, 2.3
              schema:
                type: string
            Last-Modified:
              description: Timestamp for last modification of the resource, as described in RFC 7232, 2.2
              schema:
                type: string
        '403':
          description: Forbidden
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
    patch:
      summary: modify the provisioned parameter data
      operationId: ModifyPpData
      tags:
        - ProvisionedParameterData (Document)
      parameters:
        - name: ueId
          in: path
          description: pp data for a UE
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
      requestBody:
        content:
          application/json-patch+json:
            schema:
              type: array
              items:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/PatchItem'
        required: true
      responses:
        '204':
          description: Expected response to a valid request
        '403':
          description: modification is rejected
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
                
  /subscription-data/{ueId}/context-data/ee-subscriptions:
    get:
      summary: Retrieves the ee subscriptions of a UE
      operationId: Queryeesubscriptions
      tags:
        - Event Exposure Subscriptions (Collection)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: supported-features
          in: query
          description: Supported Features
          schema:
             $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
      responses:
        '200':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
               type: array
               items:
                $ref: '#/components/schemas/EeSubscription'
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
    post:
      summary: Create individual EE subscription
      operationId: CreateEeSubscriptions
      tags:
        - Event Exposure Subscriptions (Collection)
      parameters:
        - name: ueId
          in: path
          description: UE ID
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EeSubscription'
        required: true
      responses:
        '201':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EeSubscription'
          headers:
            Location:
              description: 'Contains the URI of the newly created resource, according to the structure: {apiRoot}/subscription-data/{ueId}/context-data/ee-subscriptions/{subsId}'
              required: true
              schema:
                type: string
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'

  /subscription-data/{ueId}/context-data/ee-subscriptions/{subsId}:
    put:
      summary: Stores an individual ee subscriptions of a UE
      operationId: UpdateEesubscriptions
      tags:
        - Event Exposure Subscription (Document)
      parameters:
        - name: ueId
          in: path
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: subsId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EeSubscription'
      responses:
        '204':
          description: Upon success, an empty response body shall be returned
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
    delete:
      summary: Deletes a eeSubscription
      operationId: RemoveeeSubscriptions
      tags:
        - Event Exposure Subscription (Document)
      parameters:
        - name: ueId
          in: path
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: subsId
          in: path
          required: true
          description: Unique ID of the subscription to remove
          schema:
            type: string
      responses:
        '204':
          description: Expected response to a successful subscription removal

  /subscription-data/{ueId}/context-data/ee-subscriptions/{subsId}/amf-subscriptions:
    put:
      summary: Create AmfSubscriptions for an individual ee subscriptions of a UE
      operationId: Create AMF Subscriptions
      tags:
        - AMF Subscription Info (Document)
      parameters:
        - name: ueId
          in: path
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: subsId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/AmfSubscriptionInfo'
              minItems: 1
        required: true
      responses:
        '204':
          description: Upon success, an empty response body shall be returned
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
    delete:
      summary: Deletes AMF Subscription Info for an eeSubscription
      operationId: RemoveAmfSubscriptionsInfo
      tags:
        - Event AMF Subscription Info (Document)
      parameters:
        - name: ueId
          in: path
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: subsId
          in: path
          required: true
          schema:
            type: string
      responses:
        '204':
          description: Expected response to a successful subscription removal
    patch:
      summary: modify the AMF Subscription Info
      operationId: ModifyAmfSubscriptionInfo
      tags:
        - AmfSubscriptionInfo (Document)
      parameters:
        - name: ueId
          in: path
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: subsId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json-patch+json:
            schema:
              type: array
              items:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/PatchItem'
        required: true
      responses:
        '204':
          description: Expected response to a valid request
        '403':
          description: modification is rejected
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
    get:
      summary: Retrieve AMF subscription Info
      operationId: GetAmfSubscriptionInfo
      tags:
        - Query AMF Subscription Info (Document)
      parameters:
        - name: ueId
          in: path
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: subsId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AmfSubscriptionInfo'
                minItems: 1
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'

  /subscription-data/group-data/{ueGroupId}/ee-subscriptions:
    get:
      summary: Retrieves the ee subscriptions of a group of UEs or any UE
      operationId: QueryEeGroupSubscriptions
      tags:
        - Event Exposure Group Subscriptions (Collection)
      parameters:
        - name: ueGroupId
          in: path
          description: Group of UEs or any UE
          required: true
          schema:
              $ref: '#/components/schemas/VarUeGroupId'
        - name: supported-features
          in: query
          description: Supported Features
          schema:
             $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
      responses:
        '200':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
               type: array
               items:
                $ref: '#/components/schemas/EeSubscription'
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
    post:
      summary: Create individual EE subscription for a group of UEs or any UE
      operationId: CreateEeGroupSubscriptions
      tags:
        - Event Exposure Group Subscriptions (Collection)
      parameters:
        - name: ueGroupId
          in: path
          description: Group of UEs or any UE
          required: true
          schema:
              $ref: '#/components/schemas/VarUeGroupId'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EeSubscription'
        required: true
      responses:
        '201':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EeSubscription'
          headers:
            Location:
              description: 'Contains the URI of the newly created resource, according to the structure: {apiRoot}/nudr-dr/v1/subscription-data/group-data/{ueGroupId}/ee-subscriptions '
              required: true
              schema:
                type: string
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'

  /subscription-data/group-data/{ueGroupId}/ee-subscriptions/{subsId}:
    put:
      summary: Stores an individual ee subscription of a group of UEs or any UE
      operationId: UpdateEeGroupSubscriptions
      tags:
        - Event Exposure Subscription (Document)
      parameters:
        - name: ueGroupId
          in: path
          required: true
          schema:
              $ref: '#/components/schemas/VarUeGroupId'
        - name: subsId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EeSubscription'
      responses:
        '204':
          description: Upon success, an empty response body shall be returned
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
    delete:
      summary: Deletes a eeSubscription for a group of UEs or any UE
      operationId: RemoveEeGroupSubscriptions
      tags:
        - Event Exposure Subscription (Document)
      parameters:
        - name: ueGroupId
          in: path
          required: true
          schema:
              $ref: '#/components/schemas/VarUeGroupId'
        - name: subsId
          in: path
          required: true
          description: Unique ID of the subscription to remove
          schema:
            type: string
      responses:
        '204':
          description: Expected response to a successful subscription removal
         
  /subscription-data/{ueId}/ee-profile-data:
    get:
      summary: Retrieves the ee profile data of a UE
      operationId: QueryEEData
      tags:
        - Event Exposure Data (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: fields
          in: query
          description: attributes to be retrieved
          required: false
          schema:
            type: array
            items:
              type: string
          style: form
          explode: false
        - name: supportedFeatures
          in: query
          description: Supported Features
          schema:
             $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
      responses:
        '200':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EeProfileData'
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'

          
  /subscription-data/{ueId}/context-data/sdm-subscriptions:
    get:
      summary: Retrieves the sdm subscriptions of a UE
      operationId: Querysdmsubscriptions
      tags:
        - SDM Subscriptions (Collection)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: supported-features
          in: query
          description: Supported Features
          schema:
             $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
      responses:
        '200':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
               type: array
               items:
                $ref: '#/components/schemas/SdmSubscription'
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
    post:
      summary: Create individual sdm subscription
      operationId: CreateSdmSubscriptions
      tags:
        - SDM Subscriptions (Collection)
      parameters:
        - name: ueId
          in: path
          description: UE ID
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SdmSubscription'
        required: true
      responses:
        '201':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SdmSubscription'
          headers:
            Location:
              description: 'Contains the URI of the newly created resource, according to the structure: {apiRoot}/subscription-data/{ueId}/context-data/sdm-subscriptions/{subsId}'
              required: true
              schema:
                type: string
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'

  /subscription-data/{ueId}/context-data/sdm-subscriptions/{subsId}:  
    put:
      summary: Stores an individual sdm subscriptions of a UE
      operationId: Updatesdmsubscriptions
      tags:
        - SDM Subscription (Document)
      parameters:
        - name: ueId
          in: path
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: subsId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SdmSubscription'
      responses:
        '204':
          description: Upon success, an empty response body shall be returned
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
    delete:
      summary: Deletes a sdmsubscriptions
      operationId: RemovesdmSubscriptions
      tags:
        - SDM Subscription (Document)
      parameters:
        - name: ueId
          in: path
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: subsId
          in: path
          required: true
          description: Unique ID of the subscription to remove
          schema:
            type: string
      responses:
        '204':
          description: Expected response to a successful subscription removal


  /subscription-data/shared-data:
    get:
      summary: retrieve shared data
      operationId: GetSharedData
      tags:
        - Retrieval of shared data
      parameters:
        - name: shared-data-ids
          in: query
          description: List of shared data ids
          required: true
          style: form
          explode: false
          schema:
             $ref: 'TS29503_Nudm_SDM.yaml#/components/schemas/SharedDataIds'
        - name: supportedFeatures
          in: query
          description: Supported Features
          schema:
             $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
      responses:
        '200':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: 'TS29503_Nudm_SDM.yaml#/components/schemas/SharedData'
                minItems: 1
        '400':
          $ref: 'TS29571_CommonData.yaml#/components/responses/400'
        '404':
          $ref: 'TS29571_CommonData.yaml#/components/responses/404'
        '500':
          $ref: 'TS29571_CommonData.yaml#/components/responses/500'
        '503':
          $ref: 'TS29571_CommonData.yaml#/components/responses/503'
        default:
          description: Unexpected error
  /subscription-data/subs-to-notify:
    post:
      summary: Subscription data subscriptions
      operationId: SubscriptionDataSubscriptions
      tags:
        - Subs To Nofify (Collection)
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubscriptionDataSubscriptions'
        required: true
      responses:
        '201':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubscriptionDataSubscriptions'
          headers:
            Location:
              description: 'Contains the URI of the newly created resource, according to the structure: {apiRoot}/subscription-data/subs-to-notify/{subsId}'
              required: true
              schema:
                type: string
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'
      callbacks:
        onDataChange:
          '{request.body#/callbackReference}':
            post:
              requestBody:
                required: true
                content:
                  application/json:
                    schema:
                      $ref: '#/components/schemas/DataChangeNotify'
              responses:
                '204':
                  description: Expected response to a valid request

  /subscription-data/subs-to-notify/{subsId}:  
    delete:
      summary: Deletes a subscriptionDataSubscriptions
      operationId: RemovesubscriptionDataSubscriptions
      tags:
        - Subs To Notify (Document)
      parameters:
        - name: subsId
          in: path
          required: true
          description: Unique ID of the subscription to remove
          schema:
            type: string
      responses:
        '204':
          description: Expected response to a successful subscription removal

  /subscription-data/{ueId}/{servingPlmnId}/provisioned-data/trace-data:
    get:
      summary: Retrieves the trace configuration data of a UE
      operationId: QueryTraceData
      tags:
        - Trace Data (Document)
      parameters:
        - name: ueId
          in: path
          description: UE id
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: servingPlmnId
          in: path
          description: PLMN ID
          required: true
          schema:
            $ref: '#/components/schemas/VarPlmnId'
        - name: If-None-Match
          in: header
          description: Validator for conditional requests, as described in RFC 7232, 3.2
          schema:
            type: string
        - name: If-Modified-Since
          in: header
          description: Validator for conditional requests, as described in RFC 7232, 3.3
          schema:
            type: string
      responses:
        '200':
          description: Expected response to a valid request
          content:
            application/json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/TraceData'
          headers:
            Cache-Control:
              description: Cache-Control containing max-age, as described in RFC 7234, 5.2
              schema:
                type: string
            ETag:
              description: Entity Tag, containing a strong validator, as described in RFC 7232, 2.3
              schema:
                type: string
            Last-Modified:
              description: Timestamp for last modification of the resource, as described in RFC 7232, 2.2
              schema:
                type: string
        default:
          $ref: 'TS29571_CommonData.yaml#/components/responses/default'
  /subscription-data/{ueId}/identity-data:
    get:
      summary: Retrieve identity data by SUPI or GPSI
      operationId: GetIdentityData
      tags:
        - Query Identity Data by SUPI or GPSI (Document)
      parameters:
        - name: ueId
          in: path
          description: UE ID
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        - name: If-None-Match
          in: header
          description: Validator for conditional requests, as described in RFC 7232, 3.2
          schema:
            type: string
        - name: If-Modified-Since
          in: header
          description: Validator for conditional requests, as described in RFC 7232, 3.3
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IdentityData'
          headers:
            Cache-Control:
              description: Cache-Control containing max-age, as described in RFC 7234, 5.2
              schema:
                type: string
            ETag:
              description: Entity Tag, containing a strong validator, as described in RFC 7232, 2.3
              schema:
                type: string
            Last-Modified:
              description: Timestamp for last modification of the resource, as described in RFC 7232, 2.2
              schema:
                type: string
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'

  /subscription-data/{ueId}/operator-determined-barring-data:
    get:
      summary: Retrieve ODB Data data by SUPI or GPSI
      operationId: GetOdbData
      tags:
        - Query ODB Data by SUPI or GPSI (Document)
      parameters:
        - name: ueId
          in: path
          description: UE ID
          required: true
          schema:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OperatorDeterminedBarringData'
        default:
          description: Unexpected error
          content:
            application/problem+json:
              schema:
                $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails'

components:
  schemas:
    AuthenticationSubscription:
      type: object
      required:
        - authenticationMethod
        - permanentKey
        - sequenceNumber
      properties:
        authenticationMethod:
          $ref: '#/components/schemas/AuthMethod'
        permanentKey:
          $ref: '#/components/schemas/PermanentKey'
        sequenceNumber:
          $ref: '#/components/schemas/SequenceNumber'
        authenticationManagementField:
          $ref: '#/components/schemas/AuthenticationManagementField'
        vectorAlgorithm:
          $ref: '#/components/schemas/VectorAlgorithm'
        milenage:
          $ref: '#/components/schemas/Milenage'
        tuak:
          $ref: '#/components/schemas/Tuak'
        opc:
          $ref: '#/components/schemas/Opc'
        topc:
          $ref: '#/components/schemas/Topc'
        sharedAuthenticationSubscriptionId:
          $ref: 'TS29503_Nudm_SDM.yaml#/components/schemas/SharedData'

    SharedAuthenticationSubscription:
      type: object
      required:
        - authenticationMethod
        - vectorAlgorithm
      properties:
        authenticationManagementField:
          $ref: '#/components/schemas/AuthenticationManagementField'
        vectorAlgorithm:
          $ref: '#/components/schemas/VectorAlgorithm'
        milenage:
          $ref: '#/components/schemas/Milenage'
        tuak:
          $ref: '#/components/schemas/Tuak'


    PermanentKey:
      type: object
      required:
        - permanentKeyValue
        - encryptionKey
        - encryptionAlgorithm
      properties:
        permanentKeyValue:
          $ref: '#/components/schemas/PermanentKeyValue'
        encryptionKey:
          $ref: '#/components/schemas/EncryptionKey'
        encryptionAlgorithm:
          $ref: '#/components/schemas/EncryptionAlgorithm'


    Milenage:
      type: object
      properties:
        op:
          $ref: '#/components/schemas/Op'
        rotations:
          $ref: '#/components/schemas/Rotations'
        constants:
          $ref: '#/components/schemas/Constants'

    Tuak:
      type: object
      properties:
        top:
          $ref: '#/components/schemas/Top'
        keccakIterations:
          type: integer
          minimum: 1
          maximum: 255


    Op:
      type: object
      required:
        - opValue
        - encryptionKey
        - encryptionAlgorithm
      properties:
        opValue:
          $ref: '#/components/schemas/OpValue'
        encryptionKey:
          $ref: '#/components/schemas/EncryptionKey'
        encryptionAlgorithm:
          $ref: '#/components/schemas/EncryptionAlgorithm'

    Opc:
      type: object
      required:
        - opcValue
        - encryptionKey
        - encryptionAlgorithm
      properties:
        opcValue:
          $ref: '#/components/schemas/OpcValue'
        encryptionKey:
          $ref: '#/components/schemas/EncryptionKey'
        encryptionAlgorithm:
          $ref: '#/components/schemas/EncryptionAlgorithm'

    Top:
      type: object
      required:
        - topValue
        - encryptionKey
        - encryptionAlgorithm
      properties:
        topValue:
          $ref: '#/components/schemas/TopValue'
        encryptionKey:
          $ref: '#/components/schemas/EncryptionKey'
        encryptionAlgorithm:
          $ref: '#/components/schemas/EncryptionAlgorithm'

    Topc:
      type: object
      required:
        - topcValue
        - encryptionKey
        - encryptionAlgorithm
      properties:
        topcValue:
          $ref: '#/components/schemas/TopcValue'
        encryptionKey:
          $ref: '#/components/schemas/EncryptionKey'
        encryptionAlgorithm:
          $ref: '#/components/schemas/EncryptionAlgorithm'

    Rotations:
      type: object
      required:
        - r1
        - r2
        - r3
        - r4
        - r5
      properties:
        r1:
          $ref: '#/components/schemas/RValue'
        r2:
          $ref: '#/components/schemas/RValue'
        r3:
          $ref: '#/components/schemas/RValue'
        r4:
          $ref: '#/components/schemas/RValue'
        r5:
          $ref: '#/components/schemas/RValue'

    Constants:
      type: object
      required:
        - c1
        - c2
        - c3
        - c4
        - c5
      properties:
        c1:
          $ref: '#/components/schemas/CValue'
        c2:
          $ref: '#/components/schemas/CValue'
        c3:
          $ref: '#/components/schemas/CValue'
        c4:
          $ref: '#/components/schemas/CValue'
        c5:
          $ref: '#/components/schemas/CValue'

    PermanentKeyValue:
      type: string
      pattern: '^[A-Fa-f0-9]+$'
    SequenceNumber:
      type: string
      pattern: '^[A-Fa-f0-9]{12}$'
    AuthenticationManagementField:
      type: string
      pattern: '^[A-Fa-f0-9]{4}$'
    OpValue:
      type: string
      pattern: '^[A-Fa-f0-9]+$'
    OpcValue:
      type: string
      pattern: '^[A-Fa-f0-9]+$'
    TopValue:
      type: string
      pattern: '^[A-Fa-f0-9]+$'
    TopcValue:
      type: string
      pattern: '^[A-Fa-f0-9]+$'
    RValue:
      type: string
      pattern: '^[A-Fa-f0-9]+$'
    CValue:
      type: string
      pattern: '^[A-Fa-f0-9]+$'
    EncryptionKey:
      type: integer
    EncryptionAlgorithm:
      type: integer
    VectorAlgorithm:
      type: string
      enum:
        - MILENAGE
        - TUAK
    VarPlmnId:
      type: string
      pattern: '^[0-9]{5,6}$'
    DatasetNames:
      type: array
      items: 
        $ref: '#/components/schemas/DataSetName'
      minItems: 1
      uniqueItems: true
    DataSetName:
      anyOf:
      - type: string
        enum:
        - AM
        - SMF_SEL
        - SMS_SUB
        - SM
        - TRACE
        - SMS_MNG
      - type: string
    ProvisionedDataSets:
      type: object
      properties:
        amData:
          $ref: '#/components/schemas/AccessAndMobilitySubscriptionData'
        smfSelData:
          $ref: '#/components/schemas/SmfSelectionSubscriptionData'
        smsSubsData:
          $ref: '#/components/schemas/SmsSubscriptionData'
        smData:
          type: array
          items:
            $ref: '#/components/schemas/SessionManagementSubscriptionData'
        traceData:
          $ref: 'TS29571_CommonData.yaml#/components/schemas/TraceData'
        smsMngData:
          $ref: '#/components/schemas/SmsManagementSubscriptionData'
    AccessAndMobilitySubscriptionData:
      $ref: 'TS29503_Nudm_SDM.yaml#/components/schemas/AccessAndMobilitySubscriptionData'
    SmfSelectionSubscriptionData:
      $ref: 'TS29503_Nudm_SDM.yaml#/components/schemas/SmfSelectionSubscriptionData'
    VarSnssai:
      $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai'
    Dnn:
      $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnn'
    SessionManagementSubscriptionData:
      $ref: 'TS29503_Nudm_SDM.yaml#/components/schemas/SessionManagementSubscriptionData'
    Amf3GppAccessRegistration:
      $ref: 'TS29503_Nudm_UECM.yaml#/components/schemas/Amf3GppAccessRegistration'
    AmfNon3GppAccessRegistration:
      $ref: 'TS29503_Nudm_UECM.yaml#/components/schemas/AmfNon3GppAccessRegistration'
    SmfRegistration:
      $ref: 'TS29503_Nudm_UECM.yaml#/components/schemas/SmfRegistration'
    SmsfRegistration:
      $ref: 'TS29503_Nudm_UECM.yaml#/components/schemas/SmsfRegistration'
    SmsManagementSubscriptionData:
      $ref: 'TS29503_Nudm_SDM.yaml#/components/schemas/SmsManagementSubscriptionData'
    SmsSubscriptionData:
      $ref: 'TS29503_Nudm_SDM.yaml#/components/schemas/SmsSubscriptionData'
    OperatorSpecificDataContainer:
      type: object
      properties:
        StringTypeElements:
          type: object
          additionalProperties:
            type: string
        IntegerTypeElements:
          type: object
          additionalProperties:
            type: integer
        NumberTypeElements:
          type: object
          additionalProperties:
            type: number
        BooleanTypeElements:
          type: object
          additionalProperties:
            type: boolean
    AuthMethod:
      type: string
      enum:
        - 5G_AKA
        - EAP_AKA_PRIME
    PpData:
      $ref: 'TS29503_Nudm_PP.yaml#/components/schemas/PpData'
    EeSubscription:
      $ref: 'TS29503_Nudm_EE.yaml#/components/schemas/EeSubscription'
    VarUeGroupId:
      type: string
      pattern: '^(extgroupid-[^@]+@[^@]+|anyUE)$'
    SdmSubscription:
      $ref: 'TS29503_Nudm_SDM.yaml#/components/schemas/SdmSubscription'
    SmfRegList:
      type: array
      items:
        $ref: '#/components/schemas/SmfRegistration'
    SubscriptionDataSubscriptions:
      type: object
      required:
        - ueId
        - callbackReference
        - originalCallbackReference
        - supported-features
      properties:
        ueId:
          $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        callbackReference:
          $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri'
        originalCallbackReference:
          $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri'
        monitoredResourceUri:
          type: array
          items:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri'
        expiry:
          $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime'
        supported-features:
          $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
    DataChangeNotify:
      type: object
      properties:
        originalCallbackReference:
          type: array
          items:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri'
          minItems: 1
        ueId:
          $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId'
        notifyItems:
          type: array
          items:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/NotifyItem'
          minItems: 1
    IdentityData:
      type: object
      properties:
        supiList:
          type: array
          items:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/Supi'
          minItems: 1
          maxItems: 2
        gpsiList:
          type: array
          items:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/Gpsi'
          minItems: 1
    SorData:
      type: object
      properties:
        sorXmacIue:
          $ref: 'TS29509_Nausf_SoRProtection.yaml#/components/schemas/SorMac'
      required:
        - sorXmacIue
    OperatorDeterminedBarringData:
      $ref: 'TS29571_CommonData.yaml#/components/schemas/OdbData' 
    EeProfileData:
      type: object
      properties:
        restrictedEventTypes:
          type: array
          items:
            $ref: 'TS29503_Nudm_EE.yaml#/components/schemas/EventType'
        supportedFeatures:
            $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
    AmfSubscriptionInfo:
      type: object
      required:
        - amfInstanceId
        - subscriptionId
      properties:
        amfInstanceId:
          $ref: 'TS29571_CommonData.yaml#/components/schemas/NfInstanceId'
        subscriptionId:
          $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri'
        subsChangeNotifyCorrelationId:
          type: string