Verato PostIdentity API

openapi: 3.2.0
info:
  title: Verato Organization AddRelationshipService Post Identity API
  version: 2026.1.2
  description: 'The Verato Organization API provides comprehensive identity management capabilities for organizations within the Verato LINK platform. This API enables you to:


    - **Ingest and manage organization identities**: Add, update, and delete organization records with rich demographic and contact information.

    - **Search and query**: Find organizations using demographic data, native IDs, or link IDs (Verato''s golden identifier).

    - **Lifecycle management**: Soft-delete and restore organization records while preserving data history.

    - **Merge and link operations**: Consolidate duplicate organizations, manage master data relationships, and maintain data lineage.

    - **Relationship management**: Define and query relationships between organizations (parent-child, affiliations, etc.).

    - **Notifications**: Track and audit identity changes and events across your organization data.


    All operations follow a standard request/response envelope pattern with audit tracking, error handling, and optional response format customization.

    '
servers:
- url: https://yourveratodomain.com/org-link-ws/svc
  description: Production Organization Link API
- url: https://yourveratodomain.com/org-link-ws/svc
  description: Sandbox Organization Link API
security:
- basicAuth: []
tags:
- name: PostIdentity
paths:
  /postIdentity:
    post:
      summary: Add an Identity (postIdentity)
      description: Adds a new identity into Verato.
      operationId: postIdentity
      requestBody:
        required: true
        description: The web service request.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ServiceRequest_postIdentity'
      responses:
        '200':
          description: Successful POST identity operation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceResponse_postIdentity'
      tags:
      - PostIdentity
  /v2/postIdentity:
    post:
      summary: Add an Identity (postIdentity)
      description: Adds a new identity into Verato.
      operationId: post_v2_postIdentity
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceResponse_v2__postIdentity'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ServiceRequest_v2__postIdentity'
            examples:
              corePerson:
                summary: Core Person
                value:
                  responseIdentityFormatNames:
                  - DEFAULT
                  - GROUP_BY_SOURCE
                  - MOST_RECENTLY_ASSERTED
                  identity:
                    sources:
                    - name: test
                      id: ja-person-5143
                    names:
                    - use: official
                      prefix: Mr.
                      first: Jordan
                      middle: A.
                      last: Avery
                      suffix: Jr.
                      credential: MBA
                    addresses:
                    - type: home
                      line1: 4567 Maplewood Ave
                      line2: Apt 8B
                      city: Riverton
                      district: Northside
                      state: NY
                      postalCode: '13579'
                      country: USA
                      latitude: 40.7128
                      longitude: -74.006
                      validFrom: '2008-06-15'
                      validTo: '2038-06-15'
                    datesOfBirth:
                    - dateOfBirth: '1985-04-12'
                    ssns:
                    - ssn: 219-08-3746
                    genders:
                    - gender: M
                    genderIdentities:
                    - genderIdentity: M
                    phoneNumbers:
                    - type: mobile
                      countryCode: '+1'
                      areaCode: '212'
                      number: '5552314'
                      extension: ''
                      validTo: '2038-06-15'
                      validFrom: '2008-06-15'
                      bestTimeToContact:
                      - day: sat
                        startTime: 09:00
                        endTime: '20:00'
                        allDay: false
                    emails:
                    - type: work
                      email: jordan.avery@samplemail.com
                      validFrom: '2008-06-15'
                      validTo: '2038-06-15'
                    deathDetails:
                    - deceased: N
                      dateOfDeath: null
                      city: null
                      county: null
                      state: null
                      country: null
                    externalUniqueIdentifier:
                    - issuer: Riverton Records
                      value: RV-42109
                      status: active
                      startDate: '2008-06-15'
                      endDate: '2038-06-15'
                    alternateIdentifiers:
                    - description: Passport
                      type: PPN
                      value: XG9876543
                      status: active
                      issuer: Fictitious Passport Office
                      issueDate: '2012-09-01'
                      startDate: '2012-09-01'
                      endDate: '2022-09-01'
                    multipleBirthIndicator:
                    - multipleBirthIndicator: false
                      multipleBirthInteger: 1
                      birthPlurality: 1
                    citizenships:
                    - citizenship: US
                    photos:
                    - url: https://images.placeholder.org/people/jordan-avery.jpg
                    sexualOrientations:
                    - sexualOrientation: ST
                    races:
                    - race: 2106-3
                    ethnicities:
                    - ethnicity: 2186-5
                    religiousAffiliations:
                    - religiousAffiliation: '1033'
                    maritalStatuses:
                    - maritalStatus: M
                    communicationLanguages:
                    - language: en
                      preferred: true
                    qualifications:
                    - type: qualification
                      qualification: MBA
                      status: active
                      issuer: Westbridge University
                      issueDate: '2010-05-22'
                      validFrom: '2010-05-22'
                      validTo: '2030-05-22'
                    consents:
                    - name: Data Sharing Consent
                      type: hcd
                      status: active
                      isRequired: true
                      decision: permit
                      validFrom: '2019-01-01'
                      validTo: '2029-01-01'
                      source: participant
                      regulatoryBasis: hipaa-restrictions
                    preferences:
                    - name: SMS Alerts
                      type: SMS
                      channels:
                      - type: SMSWRIT
                        isOptedIn: true
                        lastOptedInDate: '2025-07-01'
                        frequency: monthly
                        preferredStartTime: 09:00
                        preferredEndTime: '21:00'
      tags:
      - PostIdentity
components:
  schemas:
    citizenships:
      type: object
      properties:
        citizenship:
          $ref: '#/components/schemas/CODE-SET_2'
    PhoneNumberPerSource:
      type: object
      properties:
        identityCluster:
          $ref: '#/components/schemas/Phone'
        firstAsserted:
          type: string
          description: The date the source first saw this property value.
        phoneNumber:
          $ref: '#/components/schemas/Phone'
          description: The Phone Number provided by this source
        lastAssertedMetaData:
          $ref: '#/components/schemas/CustomerMetaData'
          description: Metadata specified when record data was last asserted
        lastAsserted:
          type: string
          description: The date the source last saw this property value.
        firstAssertedMetaData:
          $ref: '#/components/schemas/CustomerMetaData'
          description: Metadata specified when record data was first asserted
      description: ''
    AddressDetailsPerSource:
      type: object
      properties:
        identityCluster:
          $ref: '#/components/schemas/AddressDetails'
        firstAsserted:
          type: string
          description: The date the source first saw this property value.
        lastAssertedMetaData:
          $ref: '#/components/schemas/CustomerMetaData'
          description: Metadata specified when record data was last asserted
        addressDetails:
          $ref: '#/components/schemas/AddressDetails'
          description: The Address provided by this source
        lastAsserted:
          type: string
          description: The date the source last saw this property value.
        firstAssertedMetaData:
          $ref: '#/components/schemas/CustomerMetaData'
          description: Metadata specified when record data was first asserted
      description: ''
    contactInformation:
      type: object
      properties:
        address:
          $ref: '#/components/schemas/addresses'
        phoneList:
          type: array
          items:
            $ref: '#/components/schemas/phoneNumbers'
        faxList:
          type: array
          items:
            $ref: '#/components/schemas/faxNumbers'
        bestTimeToContact:
          $ref: '#/components/schemas/bestTimeToContact'
      example:
        address:
          line1: 123 Main St
          city: Springfield
          state: VA
          postalCode: '22150'
        phoneList:
        - number: '5551234567'
          type: WORK
          bestTimeToContact:
            day: MON
            startTime: 09:00
            endTime: '17:00'
            allDay: false
        bestTimeToContact:
          day: MON
          startTime: 09:00
          endTime: '17:00'
          allDay: false
    MergedSourceRecord:
      type: object
      properties:
        date:
          type: string
          description: The date of the source data in ISO format (yyyy-mm-dd).
        name:
          type: string
          description: The name of the data source.  Must be unique across Verato.
        id:
          type: string
          description: The ID of an identity within the given data source.
        activeNativeId:
          type: string
          description: The surviving (active) native id.
        activeSource:
          type: string
          description: The surviving (active) source name.
        timestamp:
          type: string
          description: The merge timestamp (UTC, ISO_LOCAL_DATE_TIME).
      description: A retired source record enriched with linkage metadata.
    maritalStatuses:
      type: object
      properties:
        maritalStatus:
          $ref: '#/components/schemas/CODE-SET_2'
    VerifiedAddressMetaData:
      type: object
      properties:
        verifiedAddress:
          type: string
        rdi:
          type: string
        countyFips:
          type: string
        cmra:
          type: boolean
        latitude:
          type: number
          format: double
        precision:
          type: string
        congressionalDistrict:
          type: string
        vacant:
          type: boolean
        verificationCode:
          type: string
        longitude:
          type: number
          format: double
        countyName:
          type: string
    ServiceRequest_postIdentity:
      type: object
      properties:
        content:
          $ref: '#/components/schemas/PostIdentityWsRequest'
        trackingId:
          type: string
    legalStatus:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/CODE-SET'
        source:
          $ref: '#/components/schemas/TEXT'
        effectiveDate:
          $ref: '#/components/schemas/DATE'
        verificationDate:
          $ref: '#/components/schemas/DATE'
        jurisdiction:
          $ref: '#/components/schemas/TEXT'
        registrationCountry:
          $ref: '#/components/schemas/CODE-SET'
    BOOLEAN:
      type: boolean
      description: BOOLEAN data type, see documentation for more details.
    alternateIdentifiers_2:
      type: object
      properties:
        description:
          $ref: '#/components/schemas/TEXT_2'
        type:
          $ref: '#/components/schemas/CODE-SET_2'
        value:
          $ref: '#/components/schemas/TEXT_2'
        status:
          $ref: '#/components/schemas/TEXT_2'
        issuer:
          $ref: '#/components/schemas/TEXT_2'
        issueDate:
          $ref: '#/components/schemas/DATE_2'
        startDate:
          $ref: '#/components/schemas/DATE_2'
        endDate:
          $ref: '#/components/schemas/DATE_2'
    alternateIdentifiers:
      type: object
      properties:
        description:
          $ref: '#/components/schemas/TEXT'
        type:
          $ref: '#/components/schemas/CODE-SET'
        value:
          $ref: '#/components/schemas/TEXT'
        status:
          $ref: '#/components/schemas/BOOLEAN'
        issuer:
          $ref: '#/components/schemas/TEXT'
        issueDate:
          $ref: '#/components/schemas/DATE'
        startDate:
          $ref: '#/components/schemas/DATE'
        endDate:
          $ref: '#/components/schemas/DATE'
    datesOfBirth:
      type: object
      properties:
        dateOfBirth:
          $ref: '#/components/schemas/DATE_2'
    DatesOfBirthPerSource:
      type: object
      properties:
        identityCluster:
          $ref: '#/components/schemas/DateOfBirth'
        firstAsserted:
          type: string
          description: The date the source first saw this property value.
        lastAssertedMetaData:
          $ref: '#/components/schemas/CustomerMetaData'
          description: Metadata specified when record data was last asserted
        dateOfBirth:
          $ref: '#/components/schemas/DateOfBirth'
          description: The Date Of Birth provided by this source
        lastAsserted:
          type: string
          description: The date the source last saw this property value.
        firstAssertedMetaData:
          $ref: '#/components/schemas/CustomerMetaData'
          description: Metadata specified when record data was first asserted
      description: ''
    Name:
      type: object
      properties:
        use:
          type: string
        prefix:
          type: string
        first:
          type: string
        middle:
          type: string
        last:
          type: string
        suffix:
          type: string
        credential:
          type: string
        clusterStatus:
          type: string
          enum:
          - ACTIVE
          - INACTIVE
          description: The current clusterStatus
      description: Represents a person's name
    PostIdentityWsResponse:
      type: object
      description: PostIdentity service response.
      properties:
        identityGroupedBySource:
          type: array
          description: Alternative view where info is grouped by source.
          items:
            $ref: '#/components/schemas/IdentityPerSource'
        customerSources:
          type: array
          items:
            type: string
        linkIdentity:
          description: The link identity as it exists in Verato.
          $ref: '#/components/schemas/Identity'
        linkId:
          type: string
          description: link ID of the returned identity, if any; null if no match.
        identity:
          description: Found identity, if any; null if no match.
          $ref: '#/components/schemas/Identity'
        domains:
          type: array
          description: Domains of the returned identity, if any.
          items:
            $ref: '#/components/schemas/Domain'
        customizedIdentities:
          description: Alternative views customized by view name, keyed by view name.
          type: object
          additionalProperties:
            $ref: '#/components/schemas/Identity'
        events:
          type: array
          items:
            type: object
            description: PostIdentity event (structure omitted for brevity).
        incomingIdentity:
          description: The identity being posted
          $ref: '#/components/schemas/Identity'
    ethnicities:
      type: object
      properties:
        ethnicity:
          $ref: '#/components/schemas/CODE-SET_2'
    ServiceResponse_postIdentity:
      type: object
      properties:
        auditId:
          type: string
        success:
          type: boolean
        warnings:
          type: array
          items:
            type: string
        retryableError:
          type: boolean
        message:
          type: string
        content:
          $ref: '#/components/schemas/PostIdentityWsResponse'
        errors:
          type: array
          items:
            type: string
        trackingId:
          type: string
    Domain:
      type: object
      properties:
        name:
          type: string
        id:
          type: string
    sexualOrientations:
      type: object
      properties:
        sexualOrientation:
          $ref: '#/components/schemas/CODE-SET_2'
    AddressDetails:
      type: object
      properties:
        country:
          type: string
        streetType:
          type: string
        sources:
          type: array
          items:
            $ref: '#/components/schemas/Source_2'
          description: The source for this cluster
        city:
          type: string
        zipcode4:
          type: string
        addressType:
          type: string
        houseNumber:
          type: string
        streetPostDirection:
          type: string
        unitNumber:
          type: string
        attributesMap:
          type: object
          additionalProperties: {}
        streetDirection:
          type: string
        unitType:
          type: string
        zipcode:
          type: string
        streetName:
          type: string
        state:
          type: string
        line2:
          type: string
        clusterStatus:
          type: string
          enum:
          - ACTIVE
          - INACTIVE
          description: The current clusterStatus
    DATE:
      type: string
      format: date
      description: DATE data type (yyyy-MM-dd), see documentation for more details.
    CODE-SET:
      type: string
      description: CODE-SET data type, see documentation for more details.
    consents:
      type: object
      properties:
        name:
          $ref: '#/components/schemas/TEXT_2'
        type:
          $ref: '#/components/schemas/CODE-SET_2'
        status:
          $ref: '#/components/schemas/CODE-SET_2'
        isRequired:
          $ref: '#/components/schemas/BOOLEAN_2'
        decision:
          $ref: '#/components/schemas/CODE-SET_2'
        validFrom:
          $ref: '#/components/schemas/DATE_2'
        validTo:
          $ref: '#/components/schemas/DATE_2'
        source:
          $ref: '#/components/schemas/TEXT_2'
        regulatoryBasis:
          $ref: '#/components/schemas/CODE-SET_2'
    PostIdentityIdentity:
      description: Identity payload used when posting a new identity. Extends the base Identity model with a sources array that associates the identity with one or more data sources.
      allOf:
      - $ref: '#/components/schemas/Identity_2'
      - type: object
        required:
        - sources
        properties:
          sources:
            type: array
            minItems: 1
            maxItems: 1
            description: The data source that provided this identity. Exactly one source is required per request.
            items:
              $ref: '#/components/schemas/PostIdentitySource'
    addresses_2:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/CODE-SET_2'
        line1:
          $ref: '#/components/schemas/TEXT_2'
        line2:
          $ref: '#/components/schemas/TEXT_2'
        city:
          $ref: '#/components/schemas/TEXT_2'
        district:
          $ref: '#/components/schemas/TEXT_2'
        state:
          $ref: '#/components/schemas/TEXT_2'
        postalCode:
          $ref: '#/components/schemas/TEXT_2'
        country:
          $ref: '#/components/schemas/TEXT_2'
        latitude:
          $ref: '#/components/schemas/NUMBER_2'
        longitude:
          $ref: '#/components/schemas/NUMBER_2'
        validFrom:
          $ref: '#/components/schemas/DATE_2'
        validTo:
          $ref: '#/components/schemas/DATE_2'
    Identity:
      type: object
      description: 'Logical identity in the Verato platform. Contains domain-specific

        attributes for Person, Provider, Health Facility, and Organization.

        '
      properties:
        organizationNames:
          type: array
          items:
            $ref: '#/components/schemas/organizationNames'
        addresses:
          type: array
          items:
            $ref: '#/components/schemas/addresses'
        contactInformation:
          type: array
          items:
            $ref: '#/components/schemas/contactInformation'
        phoneNumbers:
          type: array
          items:
            $ref: '#/components/schemas/phoneNumbers'
        faxNumbers:
          type: array
          items:
            $ref: '#/components/schemas/faxNumbers'
        emails:
          type: array
          items:
            $ref: '#/components/schemas/emails'
        alternateIdentifiers:
          type: array
          items:
            $ref: '#/components/schemas/alternateIdentifiers'
        externalUniqueIdentifier:
          type: array
          items:
            $ref: '#/components/schemas/externalUniqueIdentifier'
        authorizedOfficials:
          type: array
          items:
            $ref: '#/components/schemas/authorizedOfficials'
        employerIdentificationNumber:
          type: array
          items:
            $ref: '#/components/schemas/employerIdentificationNumber'
        naicsClassifications:
          type: array
          items:
            $ref: '#/components/schemas/naicsClassifications'
        sicClassifications:
          type: array
          items:
            $ref: '#/components/schemas/sicClassifications'
        qualifications:
          type: array
          items:
            $ref: '#/components/schemas/qualifications'
        types:
          type: array
          items:
            $ref: '#/components/schemas/types'
        contactOther:
          type: array
          items:
            $ref: '#/components/schemas/contactOther'
        product:
          type: array
          items:
            $ref: '#/components/schemas/product'
        numberOfEmployees:
          type: array
          items:
            $ref: '#/components/schemas/numberOfEmployees'
        foundedDate:
          type: array
          items:
            $ref: '#/components/schemas/foundedDate'
        annualRevenue:
          type: array
          items:
            $ref: '#/components/schemas/annualRevenue'
        legalStatus:
          type: array
          items:
            $ref: '#/components/schemas/legalStatus'
    annualRevenue:
      type: object
      properties:
        annualRevenue:
          $ref: '#/components/schemas/NUMBER'
        year:
          $ref: '#/components/schemas/NUMBER'
    EmailPerSource:
      type: object
      properties:
        identityCluster:
          $ref: '#/components/schemas/Email'
        firstAsserted:
          type: string
          description: The date the source first saw this property value.
        lastAssertedMetaData:
          $ref: '#/components/schemas/CustomerMetaData'
          description: Metadata specified when record data was last asserted
        email:
          $ref: '#/components/schemas/Email'
          description: The Email provided by this source
        lastAsserted:
          type: string
          description: The date the source last saw this property value.
        firstAssertedMetaData:
          $ref: '#/components/schemas/CustomerMetaData'
          description: Metadata specified when record data was first asserted
      description: ''
    sicClassifications:
      type: object
      properties:
        code:
          $ref: '#/components/schemas/CODE-SET'
    races:
      type: object
      properties:
        race:
          $ref: '#/components/schemas/CODE-SET_2'
    preferences:
      type: object
      properties:
        name:
          $ref: '#/components/schemas/TEXT_2'
        type:
          $ref: '#/components/schemas/TEXT_2'
        channels:
          type: array
          items: {}
    PostIdentityWsRequest:
      type: object
      description: Adds a new identity to Verato.
      required:
      - identity
      properties:
        identity:
          $ref: '#/components/schemas/Identity'
        responseIdentityFormatNames:
          type: array
          description: Names of response identity formats to include. If omitted, DEFAULT is assumed.
          items:
            type: string
    externalUniqueIdentifier:
      type: object
      properties:
        issuer:
          $ref: '#/components/schemas/TEXT'
        value:
          $ref: '#/components/schemas/TEXT'
        status:
          $ref: '#/components/schemas/TEXT'
        startDate:
          $ref: '#/components/schemas/DATE'
        endDate:
          $ref: '#/components/schemas/DATE'
    names:
      type: object
      properties:
        use:
          $ref: '#/components/schemas/CODE-SET_2'
        prefix:
          $ref: '#/components/schemas/TEXT_2'
        first:
          $ref: '#/components/schemas/TEXT_2'
        middle:
          $ref: '#/components/schemas/TEXT_2'
        last:
          $ref: '#/components/schemas/TEXT_2'
        suffix:
          $ref: '#/components/schemas/TEXT_2'
        credential:
          $ref: '#/components/schemas/TEXT_2'
    NamePerSource:
      type: object
      properties:
        identityCluster:
          $ref: '#/components/schemas/Name'
        firstAsserted:
          type: string
          description: The date the source first saw this property value.
        lastAssertedMetaData:
          $ref: '#/components/schemas/CustomerMetaData'
          description: Metadata specified when record data was last asserted
        name:
          $ref: '#/components/schemas/Name'
          description: The Name provided by this source
        lastAsserted:
          type: string
          description: The date the source last saw this property value.
        firstAssertedMetaData:
          $ref: '#/components/schemas/CustomerMetaData'
          description: Metadata specified when record data was first asserted
      description: ''
    recentEncounter:
      type: object
      properties:
        status:
          $ref: '#/components/schemas/CODE-SET_2'
        class:
          $ref: '#/components/schemas/CODE-SET_2'
        priority:
          $ref: '#/components/schemas/CODE-SET_2'
        type:
          $ref: '#/components/schemas/CODE-SET_2'
        serviceType:
          $ref: '#/components/schemas/CODE-SET_2'
        start:
          $ref: '#/components/schemas/DATE_2'
        end:
          $ref: '#/components/schemas/DATE_2'
        reason:
          $ref: '#/components/schemas/TEXT_2'
        diagnosis:
          $ref: '#/components/schemas/TEXT_2'
        specialArrangement:
          $ref: '#/components/schemas/CODE-SET_2'
        specialCourtesy:
          $ref: '#/components/schemas/CODE-SET_2'
    TIME:
      type: string
      description: TIME data type, see documentation for more details.
    NUMBER:
      type: string
      description: NUMBER data type, see documentation for more details.
    Source:
      type: object
      description: Tracks an identity to a particular source system and record ID.
      properties:
        date:
          type: string
          description: The date of the source data in ISO format (yyyy-MM-dd).
        name:
          type: string
          description: Name of the data source. Must be unique across Verato.
        id:
          type: string
          description: ID of an identity within the given data source.
    religiousAffiliations:
      type: object
      properties:
        religiousAffiliation:
          $ref: '#/components/schemas/CODE-SET_2'
    guarantor:
      type: object
      properties:
        relationship:
          $ref: '#/components/schemas/CODE-SET_2'
        firstName:
          $ref: '#/components/schemas/TEXT_2'
        middleName:
          $ref: '#/components/schemas/TEXT_2'
        lastName:
          $ref: '#/components/schemas/TEXT_2'
        suffix:
          $ref: '#/components/schemas/TEXT_2'
        dob:
          $ref: '#/components/schemas/DATE_2'
        ssn:
          $ref: '#/components/schemas/TEXT_2'
        addressLine1:
          $ref: '#/components/schemas/TEXT_2'
        addressLine2:
          $ref: '#/components/schemas/TEXT_2'
        city:
          $ref: '#/components/schemas/TEXT_2'
        state:
          $ref: '#/components/schemas/TEXT_2'
        zip:
          $ref: '#/components/schemas/TEXT_2'
        phone:
          $ref: '#/components/schemas/TEXT_2'
        onHold:
          $ref: '#/components/schemas/BOOLEAN_2'
        startDate:
          $ref: '#/components/schemas/DATE_2'
        endDate:
          $ref: '#/components/schemas/DATE_2'
    deathDetails:
      type: object
      properties:
        deceased:
          $ref: '#/components/schemas/CODE-SET_2'
        dateOfDeath:
          $ref: '#/components/schemas/DATE_2'
        city:
          $ref: '#/components/schemas/TEXT_2'
        county:
          $ref: '#/components/schemas/TEXT_2'
        state:
          $ref: '#/components/schemas/TEXT_2'
        country:
          $ref: '#/components/schemas/TEXT_2'
    genders:
      type: object
      properties:
        gender:
          $ref: '#/components/schemas/CODE-SET_2'
    contactOther:
      type: object
      properties:
        system:
          $ref: '#/components/schemas/CODE-SET'
        type:
          $ref: '#/components/schemas/CODE-SET'
        value:
          $ref: '#/components/schemas/TEXT'
        validFrom:
          $ref: '#/components/schemas/DATE'
        validTo:
          $ref: '#/components/schemas/DATE'
    communicationLanguages:
      type: object
      properties:
        language:
          $ref: '#/components/schemas/CODE-SET_2'
        preferred:
          $ref: '#/components/schemas/BOOLEAN_2'
    multipleBirthIndicator:
      type: object
      properties:
        multipleBirthIndicator:
          $ref: '#/components/schemas/BOOLEAN_2'
        multipleBirthInteger:
          $ref: '#/components/schemas/NUMBER_2'
        birthPlurality:
          $ref: '#/components/schemas/NUMBER_2'
    PostIdentityWsResponse_2:
      type: object
      properties:
        identityGroupedBySource:
          type: array
          items:
            $ref: '#/components/schemas/IdentityPerSource_2'
          description: An alternative view of the link identity where information is grouped by the source. Present if the Request object contains "GROUP_BY_SOURCE" in its identity view names list.
        linkIdentity:
          $ref: '#/components/schemas/Identity_2'
          description: the link identity as it exists in the link database
        linkId:
          type: string
          enum:
          - String
          description: LinkId of the returned Identity, if any. Null if no match found
        identity:
          type: string
          enum:
          - Identity
          description: Found identity, if any. Null if no match found
        domains:
          type: array
          items:
            $ref: '#/components/schemas/Domain'
          uniqueItems: true
          description: Domains of the returned Identity, if any. Null if none
        customizedIdentitiesWithSource:
          type: object
          additionalProperties:
            type: string
          description: An alternative view of the link

# --- truncated at 32 KB (60 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/verato/refs/heads/main/openapi/verato-postidentity-api-openapi.yml