get: 
    Summary: Search a collection of NF Instances 
    Operation ID: SearchNFInstances 
 
    Tags: 
      - NF Instances (Store) 
 
    Parameters: 
      #- Name: Accept-Encoding 
      #  in: header 
      #  description: Accept-Encoding, described in IETF RFC 7231 
       #  schema: 
      #    type: string 
      - Name: target-nf-type 
        In: query 
        Description: Type of the target NF 
        Required/Optional: true 
        Schema: 
          Reference: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/NFType' 
      - Name: requester-nf-type 
        In: query 
        Description: Type of the requester NF 
        Required/Optional: true 
        Schema: 
          Reference: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/NFType' 
        #- name: requester-nf-instance-id 
        #  in: query 
        #  description: NfInstanceId of the requester NF 
        #  schema: 
        #    $ref: 'TS29571_CommonData.yaml#/components/schemas/NfInstanceId' 
      - Name: service-names 
        In: query 
        Description: Name of the service offered by the NF 
        Schema: 
          Type: array 
          Items: 
        #    $ref: 'TS29571_CommonData.yaml#/components/schemas/ServiceName' 
          Min Items: 1 

          Unique Items: False 


        Style: form 
        Explode: false 
      - Name: requester-nf-instance-fqdn 
        In: query 
        Description: FQDN of the requester NF 
        Schema: 
          Reference: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/Fqdn' 
      - Name: target-plmn-list 
        In: query 
        Description: Id of the PLMN where the target NF is located 
        Content: 
          Application/JSON: 
            Schema: 
              Type: array 
              Items: 
                Reference: 'TS29571_CommonData.yaml#/components/schemas/PlmnId' 
              Min Items: 1 
      - Name: requester-plmn-list 
        In: query 
        Description: Id of the PLMN where the NF issuing the Discovery request is located 
        Content: 
          Application/JSON: 
            Schema: 
              Type: array 
              Items: 
                Reference: 'TS29571_CommonData.yaml#/components/schemas/PlmnId' 
              Min Items: 1 
      - Name: target-nf-instance-id 
        In: query 
        Description: Identity of the NF instance being discovered 
        Schema: 
          Reference: 'TS29571_CommonData.yaml#/components/schemas/NfInstanceId' 
      - Name: target-nf-fqdn 
        In: query 
        Description: FQDN of the NF instance being discovered 
        Schema: 
          Reference: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/Fqdn' 
      - Name: hnrf-uri 
        In: query 
        Description: Uri of the home NRF 
        Schema: 
          Reference: 'TS29571_CommonData.yaml#/components/schemas/Uri' 
      - Name: snssais 
        In: query 
        Description: Slice info of the target NF 
        Content: 
          Application/JSON: 
            Schema: 
              Type: array 
              Items: 
                Reference: 'TS29571_CommonData.yaml#/components/schemas/Snssai' 
              Min Items: 1 
      - Name: plmn-specific-snssai-list 
        In: query 
        Description: PLMN specific Slice info of the target NF 
        Content: 
          Application/JSON: 
            Schema: 
              Type: array 
              Items: 
                Reference: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/PlmnSnssai' 
              Min Items: 1 
      #- Name: requester-plmn-specific-snssai-list 
        # In: query 
        # Description: PLMN-specific slice info of the NF issuing the Discovery request 
        # Content: 
          # Application/JSON: 
            # Schema: 
              # Type: array 
              # Items: 
                # Reference: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/PlmnSnssai' 
              # Min Items: 1 
      - Name: dnn 
        In: query 
        Description: Dnn supported by the BSF, SMF or UPF 
        Schema: 
          Reference: 'TS29571_CommonData.yaml#/components/schemas/Dnn' 
      - Name: nsi-list 
        In: query 
        Description: NSI IDs that are served by the services being discovered 
        Schema: 
          Type: array 
          Items: 
            Type: string 
          Min Items: 1 
        Style: form 
        Explode: false 
      - Name: smf-serving-area 
        In: query 
        Schema: 
          Type: string 
      - Name: tai 
        In: query 
        Description: Tracking Area Identity 
        Content: 
          Application/JSON: 
            Schema: 
              Reference: 'TS29571_CommonData.yaml#/components/schemas/Tai' 
      - Name: amf-region-id 
        In: query 
        Description: AMF Region Identity 
        Schema: 
          Type: string 
      - Name: amf-set-id 
        In: query 
        Description: AMF Set Identity 
        Schema: 
          Type: string 
      - Name: guami 
        In: query 
        Description: Guami used to search for an appropriate AMF 
        Content: 
          Application/JSON: 
        Schema: 
          Reference: 'TS29571_CommonData.yaml#/components/schemas/Guami' 
      - Name: supi 
        In: query 
        Description: SUPI of the user 
        Schema: 
          Reference: 'TS29571_CommonData.yaml#/components/schemas/Supi' 
      - Name: ue-ipv4-address 
        In: query 
        Description: IPv4 address of the UE 
        Schema: 
          Reference: 'TS29571_CommonData.yaml#/components/schemas/Ipv4Addr' 
      - Name: ip-domain 
        In: query 
        Description: IP domain of the UE, which supported by BSF 
        Schema: 
          Type: string 
      - Name: ue-ipv6-prefix 
        In: query 
        Description: IPv6 prefix of the UE 
        Schema: 
          Reference: 'TS29571_CommonData.yaml#/components/schemas/Ipv6Prefix' 
      - Name: pgw-ind 
        In: query 
        Description: Combined PGW-C and SMF or a standalone SMF 
        Schema: 
          Type: boolean 
      - Name: pgw 
        In: query 
        Description: PGW FQDN of a combined PGW-C and SMF 
        Schema: 
          Reference: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/Fqdn' 
      - Name: gpsi 
        In: query 
        Description: GPSI of the user 
        Schema: 
          Reference: 'TS29571_CommonData.yaml#/components/schemas/Gpsi' 
      - Name: external-group-identity 
        In: query 
        Description: external group identifier of the user 
        Schema: 
          # Reference: 'TS29503_Nudm_SDM.yaml#/components/schemas/ExtGroupId' 
      # - Name: internal-group-identity 
        # In: query 
        # Description: internal group identifier of the user 
        # Schema: 
          # Reference: 'TS29571_CommonData.yaml#/components/schemas/GroupId' 
      # - Name: pfd-data 
        # In: query 
        # Description: pfd-data 
        # Content: 
          # Application/JSON: 
        # Schema: 
          # Reference: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/PfdData' 
      - Name: data-set 
        In: query 
        Description: data set supported by the NF 
        Schema: 
          Reference: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/DataSetId' 
      - Name: routing-indicator 
        In: query 
        Description: routing indicator in SUCI 
        Schema: 
          Type: string 
          pattern: '^[0-9]{1,4}$' 
      - Name: group-id-list 
        In: query 
        Description: Group IDs of the NFs being discovered 
        Schema: 
          Type: array 
          Items: 
            Reference: 'TS29571_CommonData.yaml#/components/schemas/NfGroupId' 
          Min Items: 1 
        Style: form 
        Explode: false 
      - Name: dnai-list 
        In: query 
        Description: Data network access identifiers of the NFs being discovered 
        Schema: 
          Type: array 
          Items: 
            Reference: 'TS29571_CommonData.yaml#/components/schemas/Dnai' 
          Min Items: 1 
        Style: form 
        Explode: false 
      - Name: pdu-session-types 
        In: query 
        Description: list of PDU Session Type required to be supported by the target NF 
        Schema: 
          Type: array 
          Items: 
            Reference: 'TS29571_CommonData.yaml#/components/schemas/PduSessionType' 
          Min Items: 1 
        Style: form 
        Explode: false 
      #- Name:  event-id-list 
        # In: query 
        # Description: Analytics event(s) requested to be supported by the Nnwdaf_AnalyticsInfo service 
        # Schema: 
          # Type: array 
          # Items: 
            # Reference: 'TS29520_Nnwdaf_AnalyticsInfo.yaml#/components/schemas/EventId' 
          # Min Items: 1 
        # Style: form 
        # Explode: false 
      #- Name:  nwdaf-event-list 
        # In: query 
        # Description: Analytics event(s) requested to be supported by the Nnwdaf_EventsSubscription service. 
        # Schema: 
          # Type: array 
          # Items: 
            # Reference: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/NwdafEvent' 
          # Min Items: 1 
        # Style: form 
        # Explode: false 
      - Name: supported-features 
        In: query 
        Description: Features required to be supported by the target NF 
        Schema: 
          Reference: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' 
      - Name: upf-iwk-eps-ind 
        In: query 
        Description: UPF supporting interworking with EPS or not 
        Schema: 
          Type: boolean 
      - Name: chf-supported-plmn 
        In: query 
        Description: PLMN ID supported by a CHF 
        Content: 
          Application/JSON: 
            Schema: 
              Reference: 'TS29571_CommonData.yaml#/components/schemas/PlmnId' 
      - Name: preferred-locality 
        In: query 
        Description: preferred target NF location 
        Schema: 
          Type: string 
      - Name: access-type 
        In: query 
        Description: AccessType supported by the target NF 
        Schema: 
          Reference: 'TS29571_CommonData.yaml#/components/schemas/AccessType' 
      - Name: limit 
        In: query 
        Description: Maximum number of NFProfiles to return in the response 
        required: false 
        Schema: 
          Type: integer 
          minimum: 1 
          Reference: 'TS29571_CommonData.yaml#/components/schemas/AccessType' 
      - Name: required-features 
        In: query 
        Description: Features required to be supported by the target NF 
        Schema: 
          Type: array 
          Items: 
          Reference: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' 
          Min Items: 1 
        Style: form 
        Explode: false 
      - Name: complex-query 
        In: query 
        Description: the complex query condition expression 
        Content: 
          Application/JSON: 
        Schema: 
          Reference: 'TS29571_CommonData.yaml#/components/schemas/ComplexQuery' 
      - Name: max-payload-size 
        In: query 
        Description: Maximum payload size of the response expressed in kilo octets 
        required: false 
        Schema: 
          Type: integer 
          maximum: 2000 
          default: 124 
      #- Name: max-payload-size-ext 
        # In: query 
        # Description: Extended query for maximum payload size of the response expressed in kilo octets 
        # required: false 
        # Schema: 
          # Type: integer 
          # default: 124 
      #- Name: ATSSS Capability 
        # Content: 
          # Application/JSON: 
        # Schema: 
          # Reference: 'TS29571_CommonData.yaml#/components/schemas/AtsssCapability' 
      #- Name: upf-ue-ip-addr-ind 
        # In: query 
        # Description: UPF supporting allocating UE IP addresses/prefixes 
        # Schema: 
          # Type: boolean 
      #- Name: client-type 
        # In: query 
        # Description: Requested client type served by the NF 
        # Content: 
          # Application/JSON: 
        # Schema: 
          # Reference: 'TS29572_Nlmf_Location.yaml#/components/schemas/ExternalClientType' 
      #- Name: lmf-id 
        # In: query 
        # Description: LMF identification to be discovered 
        # Content: 
          # Application/JSON: 
        # Schema: 
          # Reference: 'TS29572_Nlmf_Location.yaml#/components/schemas/LMFIdentification' 
      #- Name: an-node-type 
        # In: query 
        # Description: Requested AN node type served by the NF 
        # Content: 
          # Application/JSON: 
        # Schema: 
          # Reference: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/AnNodeType' 
      #- Name: rat-type 
        # In: query 
        # Description: Requested AN node type served by the NF 
        # Content: 
          # Application/JSON: 
        # Schema: 
          # Reference: 'TS29571_CommonData.yaml#/components/schemas/RatType' 
      #- Name: preferred-tai 
        # In: query 
        # Description: preferred Tracking Area Identity 
        # Content: 
          # Application/JSON: 
        # Schema: 
          # Reference: 'TS29571_CommonData.yaml#/components/schemas/Tai' 
      #- Name: preferred-nf-instances 
        # In: query 
        # Description: preferred NF Instances 
        # Schema: 
          # Type: array 
          # Reference: 'TS29571_CommonData.yaml#/components/schemas/NfInstanceId' 
          # Min Items: 1 
        # Style: form 
        # Explode: false 
      - Name: If-None-Match 
        In: header 
        Description: Validator for conditional requests, as described in IETF RFC 7232, 3.2 
        Schema: 
          Type: string 
      #- Name: target-snpn 
        # In: query 
        Description: Target SNPN Identity 
        # Content: 
          # Application/JSON: 
        Schema: 
          # Reference: 'TS29571_CommonData.yaml#/components/schemas/PlmnIdNid' 
      #- Name: requester-snpn-list 
        # In: query 
        Description: SNPN ID(s) of the NF instance issuing the Discovery request 
        # Content: 
          # Application/JSON: 
        # Schema: 
          # Type: array 
          # Items: 
          # Reference: 'TS29571_CommonData.yaml#/components/schemas/PlmnIdNid' 
          # Min Items: 1 
      #- Name: af-ee-data 
        # In: query 
        # Description: NEF exposured by the AF 
        # Content: 
          # Application/JSON: 
        # Schema: 
          # Reference: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/AfEventExposureData' 
      #- Name: w-agf-info 
        # In: query 
        Description: UPF collocated with W-AGF 
        # Content: 
          # Application/JSON: 
        # Schema: 
          # Reference: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/WAgfInfo' 
      #- Name: tngf-info 
        # In: query 
        # Description: UPF collocated with TNGF 
        # Content: 
          # Application/JSON: 
        # Schema: 
          # Reference: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/TngfInfo' 
      #- Name: twif-info 
        # In: query 
        # Description: UPF collocated with TWIF 
        # Content: 
          # Application/JSON: 
        Schema: 
          Reference: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/TwifInfo' 
      #- Name: target-nf-set-id 
        # In: query 
        Description: Target NF Set ID 
        Schema: 
          Reference: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/TwifInfo' 
      #- Name: target-nf-service-set-id 
        # In: query 
        # Description: Target NF Service Set ID 
        # Schema: 
          Reference: 'TS29571_CommonData.yaml#/components/schemas/NfServiceSetId' 
      #- Name: nef-id 
        # In: query 
        # Description: NEF ID 
        # Schema: 
          Reference: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/NefId' 
      #- Name: notification-type 
        # In: query 
        # Description: Notification Type 
        # Schema: 
          Reference: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/NotificationType' 
      #- Name: n1-msg-class 
        # In: query 
        #  Description: N1 Message Class 
        # Schema: 
          Reference: 'TS29518_Namf_Communication.yaml#/components/schemas/N1MessageClass' 
      #- Name: n2-info-class 
        # In: query 
        # Description: N2 Information Class 
        # Schema: 
          # Reference: 'TS29518_Namf_Communication.yaml#/components/schemas/N2InformationClass' 
      #- Name: serving-scope 
        # In: query 
        # Description: areas that can be served by the target NF 
        # Schema: 
          # Type: array 
          # Items: 
          # Type: string 
          # Min Items: 1 
        # Style: form 
        # Explode: false 
      #- Name: imsi 
        # In: query 
        # Description: IMSI of the requester UE to search for an appropriate NF (e.g. HSS) 
        # Schema: 
          # Type: string 
      #- Name: ims-private-identity 
        # In: query 
        # Description: IMPI of the requester UE to search for a target HSS 
        # Schema: 
          # Type: string 
      #- Name: ims-public-identity 
        # In: query 
        # Description: IMS Public Identity of the requester UE to search for a target HSS 
        # Schema: 
          # Type: string 
      #- Name: msisdn 
        # In: query 
        # Description: MSISDN of the requester UE to search for a target HSS 
        # Schema: 
          # Type: string 
      #- Name: preferred-api-versions 
        # In: query 
        # Description: Preferred API version of the services to be discovered 
        # Content: 
          # Application/JSON: 
        # Schema: 
          # Type: object 
          # additionalProperties: 
          #   Type: string 
          # minProperties: 1 
      #- Name: v2x-support-ind 
        # In: query 
        # Description: PCF supports V2X 
        # Schema: 
        #   Type: boolean 
      #- Name: redundant-gtpu 
        # In: query 
        # Description: UPF supports redundant gtp-u to be discovered 
        # Schema: 
        #   Type: boolean 
      #- Name: ipups 
        # In: query 
        # Description: UPF which is configured for IPUPS functionality to be discovered 
        # Schema: 
        #   Type: boolean 
      #- Name: scp-domain-list 
        # In: query 
        # Description: SCP domains the target SCP belongs to 
        # Schema: 
        #   Type: array 
        #   Items: 
          #   Type: string 
          # Min Items: 1 
        # Style: form 
        # Explode: false 
      #- Name: scp-domain-list 
        # In: query 
        # Description: SCP domains the target SCP belongs to         # Schema: 
        # Schema: 
        # Reference: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/Fqdn' 
      #- Name: ipv4-addr 
        # In: query 
        # Description: IPv4 address reachable through the SCP 
        # Schema: 
            # Reference: 'TS29571_CommonData.yaml#/components/schemas/Ipv4Addr' 
      #- Name: ipv6-prefix 
        # In: query 
        # Description: IPv6 prefix reachable through the SCP 
        # Schema: 
            # Reference: 'TS29571_CommonData.yaml#/components/schemas/Ipv6Prefix' 
      #- Name: served-nf-set-id 
        # In: query 
        # Description: NF Set ID served by the SCP 
        # Schema: 
            # Reference: 'TS29571_CommonData.yaml#/components/schemas/NfSetId' 
      #- Name: remote-plmn-id 
        # In: query 
        # Description: Id of the PLMN reachable through the SCP 
        # Content: 
          # Application/JSON: 
        # Schema: 
            # Reference: 'TS29571_CommonData.yaml#/components/schemas/PlmnId' 
      #- Name: data-forwarding 
        # In: query 
        # Description: UPF Instance(s) configured for data forwarding are requested 
        # Schema: 
        #   Type: boolean 
      #- Name: preferred-full-plmn 
        # In: query 
        # Description: NF Instance(s) serving the full PLMN are preferred 
        # Schema: 
        #   Type: boolean 
      #- Name: requester-features 
        # In: query 
        # Description: Features supported by the NF Service Consumer that is invoking the Nnrf_NFDiscovery service 
        # Schema: 
            # Reference: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' 
      #- Name: realm-id 
        # In: query 
        # Description: realm-id to search for an appropriate UDSF 
        # Schema: 
        #   Type: string 
      #- Name: storage-id 
        # In: query 
        # Description: storage-id to search for an appropriate UDSF 
        # Schema: 
        #   Type: string 
      #- Name: vsmf-support-ind 
        # In: query 
        # Description: storage-id to search for an appropriate UDSF 
        # Schema: 
        #   Type: boolean 
 
    Responses: 
      '200': 
        Description: Expected response to a valid request 
        Content: 
          Application/JSON: 
            Schema: 
              Reference: '#/components/schemas/SearchResult' 
        Links: 
          search: 
            operationId: RetrieveStoredSearch 
            parameters: 
              searchId: $response.body#/searchId 
            Description:
                        The 'searchId' parameter returned in the response can be used as the 'searchId' parameter in the GET request to '/searches/{searchId}' 
          completeSearch: 
            operationId: RetrieveCompleteSearch 
            parameters: 
              searchId: $response.body#/searchId 
            Description:
                        The 'searchId' parameter returned in the response can be used as the 'searchId' parameter in the GET request to '/searches/{searchId}/complete' 
        Headers: 
          Cache-Control: 
            Description: Cache-Control containing max-age, described in IETF RFC 7234, 5.2 
            Schema: 
              Type: string 
          ETag: 
            Description: Entity Tag containing a strong validator, described in IETF RFC 7232, 2.3 
            Schema: 
              Type: string 
          Content-Encoding: 
            Description: Entity Tag containing a strong validator, described in IETF RFC 7232, 2.3 
            Schema: 
              Type: string 
      '307': 
        Description: Temporary Redirect 
        Content: 
          Application/JSON: 
            Schema: 
              Reference: '#/components/schemas/SearchResult' 
        Headers: 
          Location: 
            Description: 'The URI pointing to the resource located on the redirect target NRF' 
            required: true 
            schema: 
              Type: string 
      '308': 
        Description: Permanent Redirect 
        Content: 
          Application/JSON: 
            Schema: 
              Reference: 'TS29571_CommonData.yaml#/components/schemas/RedirectResponse' 
        Headers: 
          Location: 
            Description: 'The URI pointing to the resource located on the redirect target NRF' 
            required: true 
            schema: 
              Type: string 
      '400': 
        Reference: 'TS29571_CommonData.yaml#/components/responses/400' 
      '403': 
        Reference: 'TS29571_CommonData.yaml#/components/responses/403' 
      '404': 
        Reference: 'TS29571_CommonData.yaml#/components/responses/404' 
      '411': 
        Reference: 'TS29571_CommonData.yaml#/components/responses/411' 
      '413': 
        Reference: 'TS29571_CommonData.yaml#/components/responses/413' 
      '415': 
        Reference: 'TS29571_CommonData.yaml#/components/responses/415' 
      '500': 
        Reference: 'TS29571_CommonData.yaml#/components/responses/500' 
      '501': 
        Reference: 'TS29571_CommonData.yaml#/components/responses/501' 
      '503': 
        Reference: 'TS29571_CommonData.yaml#/components/responses/503' 
      Default: 
        Reference: 'TS29571_CommonData.yaml#/components/responses/default'