openapi: 3.2.0
info:
  title: Fenergo Nebula Policy Query Get Merged Requirement Sets…
  description: Policy Query API is part of FenX eco-system to query for Requirement Sets, Requirements, Data Groups and Data Group Fields Instances. All the operations require valid access token obtained from Identity service.
  version: '2.0'
servers:
- url: /policyquery
security:
- Bearer: []
tags:
- name: GetMergedRequirementSetsDataFields
paths:
  /api/v2/requirement-set/merged-data-fields:
    post:
      tags:
      - GetMergedRequirementSetsDataFields
      summary: Gets summary of data fields from all jurisdictions merged by property name
      description: 'Required permissions:

        Following permissions are required: PolicySearch'
      operationId: GetMergedRequirementSetsDataFields
      parameters:
      - name: X-TENANT-ID
        in: header
        description: The UiD of the tenant representing organization
        required: true
        schema:
          type: string
        example: b11f8be3-f29b-4959-8964-956d4af7c468
      requestBody:
        description: Parameters used for filtering requirements
        content:
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/GetMergedRequirementSetsDataFieldsRequestDtoServiceRequest'
              description: Service request data
      responses:
        '200':
          description: Success. Data fields summary grouped by property name is returned
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMergedRequirementSetsDataFieldsResponseDtoServiceResponse'
        '400':
          description: Bad request. The request has missing/invalid values
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceResponse'
        '401':
          description: User is not authorized to perform this request
          content:
            application/json:
              example:
                message: Unauthorized
        '403':
          description: Access to resource is forbidden.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ObjectServiceResponse'
              example:
                data: {}
                messages:
                - message: 'Access denied. Following permissions are required: Permission1, Permission2'
                  type: Forbidden
                  errorCode: Error Code
        '500':
          description: Internal server exception. Please, contact your provider.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ObjectServiceResponse'
              example:
                data: null
                messages:
                - message: Internal server exception. Please, contact your provider.
                  type: Error
                  errorCode: INTERNAL_SERVER_ERROR
        '410':
          description: Endpoint marked as deprecated was terminated. This response will be present only if the endpoint was marked as deprecated and has reached the sunset date. During the deprecation period, the API will include additional 'sunset' and 'deprecation' headers.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StringServiceResponse'
              example:
                data: null
                messages:
                - message: This endpoint is obsolete and was terminated on yyyy-MM-dd
                  type: Error
                  errorCode: OBSOLETE_ENDPOINT
components:
  schemas:
    ServiceResponse:
      type: object
      properties:
        data:
          type:
          - string
          - 'null'
          description: The service response DTO
        messages:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/ServiceResponseMessage'
          description: List of Fenergo.Nebula.Platform.Core.Models.Response.ServiceResponseMessage associated to the service response
      additionalProperties: false
      description: Service response data
    GetMergedRequirementSetsDataFieldsResponseDto:
      type: object
      properties:
        dataFieldsByPropertyName:
          type:
          - object
          - 'null'
          additionalProperties:
            $ref: '#/components/schemas/DataFieldSummaryDto'
          description: Data fields summary grouped by property name
      additionalProperties: false
      description: Response DTO representing data fields summary grouped by property name
    GetMergedRequirementSetsDataFieldsRequestDto:
      type: object
      properties:
        targetEntity:
          type:
          - string
          - 'null'
          description: Requirement target entity
          example: Client
        entityType:
          type:
          - string
          - 'null'
          description: Requirement entity type
          example: Individual
        categories:
          type:
          - array
          - 'null'
          items:
            type: string
          description: Requirement business categories
          example:
          - Basic Details
        forceMergeFromRequirementSetVersionId:
          type:
          - string
          - 'null'
          description: Id of requirement set version (can be draft) forced to merge with other latest published requirement sets
          format: uuid
          example: 228313c6-91e6-4b05-a537-5a1ab906418f
        journeyLevelDataOnly:
          type: boolean
          description: Flag indicating if returned requirements will be Journey Level Data only
          example: false
      additionalProperties: false
      description: Request DTO representing parameters to filter returned data fields
    DataFieldSummaryDto:
      type: object
      properties:
        propertyType:
          type:
          - string
          - 'null'
          description: Property type
          example: text
        propertyTypeId:
          type:
          - string
          - 'null'
          description: Property type id
          format: uuid
          example: ab92ecbc-bd77-494b-acad-3d2fb0b8136c
        linkChildFieldPropertyName:
          type:
          - string
          - 'null'
          description: Linked child field property name
          example: productCategory
        linkedParentFieldPropertyName:
          type:
          - string
          - 'null'
          description: Linked Parent field property name
          example: productCategory
        externalSearchApiProviderId:
          type:
          - string
          - 'null'
          description: External search api provider id
          format: uuid
          example: ab92ecbc-bd77-494b-acad-3d2fb0b8136c
        name:
          type:
          - string
          - 'null'
          description: Requirement name
          example: First Name
        mergedNames:
          type:
          - string
          - 'null'
          description: Merged requirement names in case of different duplicates
          example: First Name | Name
          deprecated: true
        names:
          type:
          - array
          - 'null'
          items:
            type: string
          description: Requirement names in case of different duplicates
          example:
          - First Name
          - Name
        description:
          type:
          - string
          - 'null'
          description: Requirement description
          example: This is the client first name
        categories:
          uniqueItems: true
          type:
          - array
          - 'null'
          items:
            type: string
          description: All requirement business categories for property
          example:
          - Basic Details
        jurisdictions:
          uniqueItems: true
          type:
          - array
          - 'null'
          items:
            type: string
          description: All requirement jurisdictions for property
          example:
          - Global
        isSensitiveData:
          type: boolean
          description: Requirement sensitive data flag
          example: true
      additionalProperties: false
      description: Response DTO representing data field summary
    GetMergedRequirementSetsDataFieldsResponseDtoServiceResponse:
      type: object
      properties:
        data:
          allOf:
          - $ref: '#/components/schemas/GetMergedRequirementSetsDataFieldsResponseDto'
          description: Response DTO representing data fields summary grouped by property name
        messages:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/ServiceResponseMessage'
          description: List of Fenergo.Nebula.Platform.Core.Models.Response.ServiceResponseMessage associated to the service response
      additionalProperties: false
      description: Service response data
    ServiceResponseMessage:
      type: object
      properties:
        message:
          type:
          - string
          - 'null'
          description: The message
          example: Success
        type:
          type:
          - string
          - 'null'
          description: 'Type of the message

            One of Info, Warning, Error, Forbidden'
          example: Info
        errorCode:
          type:
          - string
          - 'null'
          description: Error Code
          example: INTERNAL_SERVER_ERROR
      additionalProperties: false
      description: The message associated to the service response
    GetMergedRequirementSetsDataFieldsRequestDtoServiceRequest:
      type: object
      properties:
        data:
          allOf:
          - $ref: '#/components/schemas/GetMergedRequirementSetsDataFieldsRequestDto'
          description: Request DTO representing parameters to filter returned data fields
      additionalProperties: false
      description: Service request data
    ObjectServiceResponse:
      type: object
      properties:
        data:
          description: The service response DTO
        messages:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/ServiceResponseMessage'
          description: List of Fenergo.Nebula.Platform.Core.Models.Response.ServiceResponseMessage associated to the service response
      additionalProperties: false
      description: Service response data
    StringServiceResponse:
      type: object
      properties:
        data:
          type:
          - string
          - 'null'
          description: The service response DTO
        messages:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/ServiceResponseMessage'
          description: List of Fenergo.Nebula.Platform.Core.Models.Response.ServiceResponseMessage associated to the service response
      additionalProperties: false
      description: Service response data
  securitySchemes:
    Bearer:
      type: apiKey
      description: Please insert JWT with Bearer into field
      name: Authorization
      in: header