First American Ownership API

swagger: '2.0'
info:
  description: ''
  version: 1.0.0
  title: Ownership Service
host: api-w2.firstam.io
basePath: /v1
schemes:
- https
paths:
  /ownership/order/full:
    post:
      tags:
      - RequestOwnership
      summary: Make a new Ownership service call
      description: 'Required fields: First Name, Last Name, SSN. Alerts and Analytics can be added by
        setting the "IncludeAnalytics" flag in the request body to true.'
      operationId: reqOwnership
      consumes:
      - application/json
      - application/xml
      produces:
      - application/json
      - application/xml
      parameters:
      - in: header
        name: x-app-id
        description: Application ID
        required: true
        type: string
      - in: header
        name: x-app-key
        description: Application Key
        required: true
        type: string
      - in: body
        name: Request
        description: Request for Ownership
        schema:
          $ref: '#/definitions/OwnershipRequest'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/OwnershipResponse'
        '400':
          description: Invalid Input, Object Invalid
  /ownership/order/prime:
    post:
      tags:
      - RequestOwnership
      summary: Make a new Ownership service call
      description: 'Required fields: First Name, Last Name, SSN. Alerts and Analytics can be added by
        setting the "IncludeAnalytics" flag in the request body to true.'
      operationId: reqOwnership
      consumes:
      - application/json
      - application/xml
      produces:
      - application/json
      - application/xml
      parameters:
      - in: header
        name: x-app-id
        description: Application ID
        required: true
        type: string
      - in: header
        name: x-app-key
        description: Application Key
        required: true
        type: string
      - in: body
        name: Request
        description: Request for Ownership
        schema:
          $ref: '#/definitions/OwnershipRequest'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/OwnershipResponse'
        '400':
          description: Invalid Input, Object Invalid
  /ownership/order/address:
    post:
      tags:
      - RequestOwnership
      summary: Make a new Ownership service call to get a quick summary of addresses owned.
      description: 'Required fields: First Name, Last Name, SSN. Alerts and Analytics can be added by
        setting the "IncludeAnalytics" flag in the request body to true.'
      operationId: reqAddress
      consumes:
      - application/json
      - application/xml
      produces:
      - application/json
      - application/xml
      parameters:
      - in: header
        name: x-app-id
        description: Application ID
        required: true
        type: string
      - in: header
        name: x-app-key
        description: Application Key
        required: true
        type: string
      - in: body
        name: Request
        description: Request for Ownership
        schema:
          $ref: '#/definitions/OwnershipRequest'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/OwnershipAddressResponse'
        '400':
          description: Invalid Input, Object Invalid
  /ownership/order/details:
    post:
      tags:
      - RequestOwnership
      summary: Make a new Ownership service call to get all property transaction details.
      description: 'Required fields: First Name, Last Name, SSN. Alerts and Analytics can be added by
        setting the "IncludeAnalytics" flag in the request body to true.'
      operationId: reqDetails
      consumes:
      - application/json
      - application/xml
      produces:
      - application/json
      - application/xml
      parameters:
      - in: header
        name: x-app-id
        description: Application ID
        required: true
        type: string
      - in: header
        name: x-app-key
        description: Application Key
        required: true
        type: string
      - in: body
        name: Request
        description: Request for Ownership
        schema:
          $ref: '#/definitions/OwnershipRequest'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/OwnershipDetailResponse'
        '400':
          description: Invalid Input, Object Invalid
  /ownership/order/preforeclosure:
    post:
      tags:
      - RequestOwnership
      summary: Make a new Ownership service call that provides back Properties Owned in Pre-Foreclosure.
      description: 'Required fields: First Name, Last Name, SSN. Alerts and Analytics can be added by
        setting the "IncludeAnalytics" flag in the request body to true.'
      operationId: reqPreforeclosure
      consumes:
      - application/json
      - application/xml
      produces:
      - application/json
      - application/xml
      parameters:
      - in: header
        name: x-app-id
        description: Application ID
        required: true
        type: string
      - in: header
        name: x-app-key
        description: Application Key
        required: true
        type: string
      - in: body
        name: Request
        description: Request for Ownership
        schema:
          $ref: '#/definitions/OwnershipRequest'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/OwnershipPreforeclosureResponse'
        '400':
          description: Invalid Input, Object Invalid
  /ownership/order/schedulereo:
    post:
      tags:
      - RequestOwnership
      summary: Make a new Ownership service call that provides back Properties Owned for Schedule of Real
        Estate Owned to Pre-Populate URLA 1003 Section 3 Rev. 8/2016.
      description: 'Required fields: First Name, Last Name, SSN. Alerts and Analytics can be added by
        setting the "IncludeAnalytics" flag in the request body to true.'
      operationId: reqScheduleREO
      consumes:
      - application/json
      - application/xml
      produces:
      - application/json
      - application/xml
      parameters:
      - in: header
        name: x-app-id
        description: Application ID
        required: true
        type: string
      - in: header
        name: x-app-key
        description: Application Key
        required: true
        type: string
      - in: body
        name: Request
        description: Request for Ownership
        schema:
          $ref: '#/definitions/OwnershipRequest'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/OwnershipScheduleREOResponse'
        '400':
          description: Invalid Input, Object Invalid
  /ownership/order/foreclosure:
    post:
      tags:
      - RequestOwnership
      summary: Make a new Ownership service call that provides back data to Pre-Populate Foreclosure data
        for URLA 1003 Section 3 Rev. 8/2016.
      description: 'Required fields: First Name, Last Name, SSN. Alerts and Analytics can be added by
        setting the "IncludeAnalytics" flag in the request body to true.'
      operationId: reqForeclosure
      consumes:
      - application/json
      - application/xml
      produces:
      - application/json
      - application/xml
      parameters:
      - in: header
        name: x-app-id
        description: Application ID
        required: true
        type: string
      - in: header
        name: x-app-key
        description: Application Key
        required: true
        type: string
      - in: body
        name: Request
        description: Request for Ownership
        schema:
          $ref: '#/definitions/OwnershipRequest'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/OwnershipForeclosureResponse'
        '400':
          description: Invalid Input, Object Invalid
  /ownership/order/previousforeclosure:
    post:
      tags:
      - RequestOwnership
      summary: Make a new Ownership service call that returns Borrower Previously Owned Foreclosure liabilities
        related to properties owned.
      description: 'Required fields: First Name, Last Name, SSN. Alerts and Analytics can be added by
        setting the "IncludeAnalytics" flag in the request body to true.'
      operationId: reqPrevForeclsoure
      consumes:
      - application/json
      - application/xml
      produces:
      - application/json
      - application/xml
      parameters:
      - in: header
        name: x-app-id
        description: Application ID
        required: true
        type: string
      - in: header
        name: x-app-key
        description: Application Key
        required: true
        type: string
      - in: body
        name: Request
        description: Request for Ownership
        schema:
          $ref: '#/definitions/OwnershipRequest'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/OwnershipDetailResponse'
        '400':
          description: Invalid Input, Object Invalid
  /ownership/report/full:
    get:
      tags:
      - GetOwnershipResponse
      summary: Retrieve existing report by transactionID
      description: Add a transactionID to the query string to retrieve an existing report
      operationId: retreiveOwnership
      produces:
      - application/json
      - application/xml
      parameters:
      - in: header
        name: x-app-id
        description: Application ID
        required: true
        type: string
      - in: header
        name: x-app-key
        description: Application Key
        required: true
        type: string
      - in: query
        name: TransactionID
        description: Transaction ID number provided
        required: true
        default: 82d9762b-70c3-4801-bd4b-8ffc8d358f77
        type: string
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/OwnershipResponse'
        '400':
          description: Invalid Request, object invalid.
        '404':
          description: No data found.
  /ownership/report/prime:
    get:
      tags:
      - GetOwnershipResponse
      summary: Retrieve existing report by transactionID
      description: Add a transactionID to the query string to retrieve an existing report
      operationId: retreiveOwnership
      produces:
      - application/json
      - application/xml
      parameters:
      - in: header
        name: x-app-id
        description: Application ID
        required: true
        type: string
      - in: header
        name: x-app-key
        description: Application Key
        required: true
        type: string
      - in: query
        name: TransactionID
        description: Transaction ID number provided
        required: true
        default: 82d9762b-70c3-4801-bd4b-8ffc8d358f77
        type: string
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/OwnershipResponse'
        '400':
          description: Invalid Request, object invalid.
        '404':
          description: No data found.
  /ownership/report/address:
    get:
      tags:
      - GetOwnershipResponse
      summary: Retrieve existing report by transactionID
      description: Add a transactionID to the query string to retrieve an existing report
      operationId: retreiveOwnership
      produces:
      - application/json
      - application/xml
      parameters:
      - in: header
        name: x-app-id
        description: Application ID
        required: true
        type: string
      - in: header
        name: x-app-key
        description: Application Key
        required: true
        type: string
      - in: query
        name: TransactionID
        description: Transaction ID number provided
        required: true
        default: 82d9762b-70c3-4801-bd4b-8ffc8d358f77
        type: string
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/OwnershipAddressResponse'
        '400':
          description: Invalid Request, object invalid.
        '404':
          description: No data found.
  /ownership/report/details:
    get:
      tags:
      - GetOwnershipResponse
      summary: Retrieve existing report by transactionID
      description: Add a transactionID to the query string to retrieve an existing report
      operationId: retreiveOwnership
      produces:
      - application/json
      - application/xml
      parameters:
      - in: header
        name: x-app-id
        description: Application ID
        required: true
        type: string
      - in: header
        name: x-app-key
        description: Application Key
        required: true
        type: string
      - in: query
        name: TransactionID
        description: Transaction ID number provided
        required: true
        default: 82d9762b-70c3-4801-bd4b-8ffc8d358f77
        type: string
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/OwnershipDetailResponse'
        '400':
          description: Invalid Request, object invalid.
        '404':
          description: No data found.
  /ownership/report/preforeclosure:
    get:
      tags:
      - GetOwnershipResponse
      summary: Retrieve existing report by transactionID
      description: Add a transactionID to the query string to retrieve an existing report
      operationId: retreiveOwnership
      produces:
      - application/json
      - application/xml
      parameters:
      - in: header
        name: x-app-id
        description: Application ID
        required: true
        type: string
      - in: header
        name: x-app-key
        description: Application Key
        required: true
        type: string
      - in: query
        name: TransactionID
        description: Transaction ID number provided
        required: true
        default: 82d9762b-70c3-4801-bd4b-8ffc8d358f77
        type: string
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/OwnershipPreforeclosureResponse'
        '400':
          description: Invalid Request, object invalid.
        '404':
          description: No data found.
  /ownership/report/schedulereo:
    get:
      tags:
      - GetOwnershipResponse
      summary: Retrieve existing report by transactionID
      description: Add a transactionID to the query string to retrieve an existing report
      operationId: retreiveOwnership
      produces:
      - application/json
      - application/xml
      parameters:
      - in: header
        name: x-app-id
        description: Application ID
        required: true
        type: string
      - in: header
        name: x-app-key
        description: Application Key
        required: true
        type: string
      - in: query
        name: TransactionID
        description: Transaction ID number provided
        required: true
        default: 82d9762b-70c3-4801-bd4b-8ffc8d358f77
        type: string
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/OwnershipScheduleREOResponse'
        '400':
          description: Invalid Request, object invalid.
        '404':
          description: No data found.
  /ownership/report/foreclosure:
    get:
      tags:
      - GetOwnershipResponse
      summary: Retrieve existing report by transactionID
      description: Add a transactionID to the query string to retrieve an existing report
      operationId: retreiveOwnership
      produces:
      - application/json
      - application/xml
      parameters:
      - in: header
        name: x-app-id
        description: Application ID
        required: true
        type: string
      - in: header
        name: x-app-key
        description: Application Key
        required: true
        type: string
      - in: query
        name: TransactionID
        description: Transaction ID number provided
        required: true
        default: 82d9762b-70c3-4801-bd4b-8ffc8d358f77
        type: string
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/OwnershipForeclosureResponse'
        '400':
          description: Invalid Request, object invalid.
        '404':
          description: No data found.
  /ownership/report/previousforeclosure:
    get:
      tags:
      - GetOwnershipResponse
      summary: Retrieve existing report by transactionID
      description: Add a transactionID to the query string to retrieve an existing report
      operationId: retreiveOwnership
      produces:
      - application/json
      - application/xml
      parameters:
      - in: header
        name: x-app-id
        description: Application ID
        required: true
        type: string
      - in: header
        name: x-app-key
        description: Application Key
        required: true
        type: string
      - in: query
        name: TransactionID
        description: Transaction ID number provided
        required: true
        default: 82d9762b-70c3-4801-bd4b-8ffc8d358f77
        type: string
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/OwnershipDetailResponse'
        '400':
          description: Invalid Request, object invalid.
        '404':
          description: No data found.
definitions:
  OwnershipRequest:
    type: object
    required:
    - Header
    - Request
    properties:
      Header:
        $ref: '#/definitions/HeaderType'
      Request:
        $ref: '#/definitions/RequestType'
    example:
      RequestorID: Test123
      Person:
        SSN: '999999914'
        Name:
          Last: Doe
          First: John
      IncludeAnalytics: false
  HeaderType:
    type: object
    required:
    - x-app-id
    - x-app-key
    properties:
      x-app-id:
        type: string
        example: '3423423423423'
      x-app-key:
        type: string
        example: '3242342342342'
  RequestType:
    required:
    - Person
    - RequestorID
    properties:
      RequestorID:
        type: string
        example: '1234'
        description: Client's EntityID or ReferenceID
      Person:
        $ref: '#/definitions/PersonType'
      CurrentAddress:
        $ref: '#/definitions/Address'
      RealEstateOwned:
        $ref: '#/definitions/RealEstateOwnedType'
      IncludeAnalytics:
        type: boolean
        example: false
        description: Option to run analytics on data set.
  PersonType:
    type: object
    required:
    - SSN
    properties:
      Name:
        $ref: '#/definitions/PersonnameType'
      Address:
        $ref: '#/definitions/Address'
      SSN:
        type: string
        example: 111-11-1234
        description: Individal SSN
        pattern: ([0-9]{3}((-[0-9]{2}-[0-9]{4})|([0-9]{6})))?
      AKAs:
        type: array
        items:
          $ref: '#/definitions/PersonnameType'
  PersonnameType:
    properties:
      FirstName:
        type: string
        example: Mark
        maxLength: 32
      MiddleName:
        type: string
        example: M
        maxLength: 32
      LastName:
        type: string
        example: Marsupial
        maxLength: 65
      Suffix:
        type: string
        example: Mr
      Prefix:
        type: string
        example: Jr
      FullName:
        type: string
        example: Mark Marsupial
    example:
      Suffix: Mr
      FirstName: Mark
      FullName: Mark Marsupial
      LastName: Marsupial
      Prefix: Jr
      MiddleName: M
  RealEstateOwnedType:
    type: object
    properties:
      Addresses:
        type: array
        items:
          $ref: '#/definitions/Address'
    example:
      Addresses:
      - StreetNumber: '5824'
        StreetName: Alder
        StreetSuffix: Ave
        City: Littleton
        State: CO
        Zip5: '80128'
        StateCityZip: CO, Littleton, 80128
      - StreetNumber: '8938'
        StreetName: Brandt
        StreetSuffix: Dr
        City: Littleton
        State: CO
        Zip5: '80123'
        StateCityZip: CO, Littleton, 80123
      - StreetNumber: '2432'
        StreetName: 38th
        StreetSuffix: Ave
        City: Denver
        State: CO
        Zip5: '80211'
        StateCityZip: CO, Denver, 80211
      - StreetNumber: '12674'
        StreetName: Grand
        StreetSuffix: Dr
        City: Morrison
        State: CO
        zip5: '80465'
        StateCityZip: CO, Morrison, 80465
      - StreetNumber: '8025'
        StreetName: Wagon Wheel
        StreetSuffix: Rd
        City: Morrison
        State: CO
        Zip5: '80465'
        StateCityZip: CO, Morrison, 80465
  OwnershipResponse:
    type: object
    properties:
      RequestorID:
        type: string
        example: loannumber1234
        description: LoanNumber or TransactionID
        minLength: 1
        maxLength: 100
      TransactionID:
        type: string
        example: 82d9762b-70c3-4801-bd4b-8ffc8d358f77
        description: TransactionID can be used to fetach data at later stage
      Properties:
        type: array
        items:
          $ref: '#/definitions/PropertyType'
      Status:
        type: string
        example: Hit
        description: Search Status
      Message:
        type: string
        example: Results are Incomplete.
        description: Order Status
      Alerts:
        type: array
        items:
          $ref: '#/definitions/AlertType'
  OwnershipAddressResponse:
    type: object
    properties:
      RequestorID:
        type: string
        example: loannumber1234
        description: LoanNumber or TransactionID
        minLength: 1
        maxLength: 100
      TransactionID:
        type: string
        example: 82d9762b-70c3-4801-bd4b-8ffc8d358f77
        description: TransactionID can be used to fetach data at later stage
      Properties:
        type: array
        items:
          $ref: '#/definitions/PropertyAddressType'
      Status:
        type: string
        example: Hit
        description: Search Status
      Message:
        type: string
        example: Results are Incomplete.
        description: Order Status
      Alerts:
        type: array
        items:
          $ref: '#/definitions/AlertType'
  OwnershipPreforeclosureResponse:
    type: object
    properties:
      RequestorID:
        type: string
        example: loannumber1234
        description: LoanNumber or TransactionID
        minLength: 1
        maxLength: 100
      TransactionID:
        type: string
        example: 82d9762b-70c3-4801-bd4b-8ffc8d358f77
        description: TransactionID can be used to fetach data at later stage
      Properties:
        type: array
        items:
          $ref: '#/definitions/PropertyPreforeclosureType'
      Status:
        type: string
        example: Hit
        description: Search Status
      Message:
        type: string
        example: Results are Incomplete.
        description: Order Status
      Alerts:
        type: array
        items:
          $ref: '#/definitions/AlertType'
  OwnershipScheduleREOResponse:
    type: object
    properties:
      RequestorID:
        type: string
        example: loannumber1234
        description: LoanNumber or TransactionID
        minLength: 1
        maxLength: 100
      TransactionID:
        type: string
        example: 82d9762b-70c3-4801-bd4b-8ffc8d358f77
        description: TransactionID can be used to fetach data at later stage
      Properties:
        type: array
        items:
          $ref: '#/definitions/PropertyScheduleREOType'
      Status:
        type: string
        example: Hit
        description: Search Status
      Message:
        type: string
        example: Results are Incomplete.
        description: Order Status
      Alerts:
        type: array
        items:
          $ref: '#/definitions/AlertType'
  OwnershipForeclosureResponse:
    type: object
    properties:
      RequestorID:
        type: string
        example: loannumber1234
        description: LoanNumber or TransactionID
        minLength: 1
        maxLength: 100
      TransactionID:
        type: string
        example: 82d9762b-70c3-4801-bd4b-8ffc8d358f77
        description: TransactionID can be used to fetach data at later stage
      Properties:
        type: array
        items:
          $ref: '#/definitions/PropertyForeclosureType'
      Status:
        type: string
        example: Hit
        description: Search Status
      Message:
        type: string
        example: Results are Incomplete.
        description: Order Status
      Alerts:
        type: array
        items:
          $ref: '#/definitions/AlertType'
  OwnershipDetailResponse:
    type: object
    properties:
      RequestorID:
        type: string
        example: loannumber1234
        description: LoanNumber or TransactionID
        minLength: 1
        maxLength: 100
      TransactionID:
        type: string
        example: 82d9762b-70c3-4801-bd4b-8ffc8d358f77
        description: TransactionID can be used to fetach data at later stage
      Properties:
        type: array
        items:
          $ref: '#/definitions/PropertyDetailType'
      Status:
        type: string
        example: Hit
        description: Search Status
      Message:
        type: string
        example: Results are Incomplete.
        description: Order Status
      Alerts:
        type: array
        items:
          $ref: '#/definitions/AlertType'
  PropertyType:
    type: object
    properties:
      StatusCode:
        example: Success
        type: string
      ProductMessage:
        $ref: '#/definitions/ProductMessage'
      PropertyLocationData:
        $ref: '#/definitions/PropertyLocationData'
      Locations:
        type: array
        items:
          $ref: '#/definitions/PropertyLocationData'
      PropertyTaxInformation:
        $ref: '#/definitions/PropertyTaxInformation'
      PropertyOwnerInformation:
        $ref: '#/definitions/PropertyOwnerInformation'
      AssesseeContactInformation:
        $ref: '#/definitions/AssesseeContactInformation'
      PropertyCharacteristics:
        $ref: '#/definitions/PropertyCharacteristics'
      AssessorLegal:
        $ref: '#/definitions/AssessorLegal'
      PropertyTransactionHistory:
        $ref: '#/definitions/PropertyTransactionHistory'
      LoanTransactionHistory:
        $ref: '#/definitions/LoanTransactionHistory'
      NearbyComparableSales:
        type: array
        items:
          $ref: '#/definitions/ComparableSale'
      AVMInformation:
        $ref: '#/definitions/AVMInformation'
      PropertyValueRange:
        $ref: '#/definitions/PropertyValueRange'
      ActiveDefault:
        $ref: '#/definitions/ActiveDefault'
      ActiveForeclosuresByZip:
        type: array
        items:
          $ref: '#/definitions/ActiveForeclosureByZip'
      NormalizedAddress:
        $ref: '#/definitions/Address'
      AssessorTaxInfo:
        $ref: '#/definitions/AssessorTaxInfo'
  PropertyDetailType:
    type: object
    properties:
      StatusCode:
        example: Success
        type: string
      PropertyLocationData:
        $ref: '#/definitions/PropertyLocationDetailData'
      OwnerInformation:
        $ref: '#/definitions/PropertyOwnerDetailInformation'
      LastMarketSale:
        $ref: '#/definitions/TransactionDetail'
      PropertyDetails:
        $ref: '#/definitions/PropertyDetails'
      LoanDetails:
        $ref: '#/definitions/LoanDetails'
      AssessorTaxInfo:
        $ref: '#/definitions/AssessorTaxInfo'
      PropertyTransactionHistory:
        type: array
        items:
          $ref: '#/definitions/TransactionDetail'
  PropertyAddressType:
    type: object
    properties:
      StatusCode:
        example: Success
        type: string
      PropertyAddress:
        $ref: '#/definitions/Address'
      Buyers:
        type: array
        items:
          $ref: '#/definitions/EntityInfo'
      Sellers:
        type: array
        items:
          $ref: '#/definitions/EntityInfo'
      RecordingDate:
        example: '20171231'
        type: string
      SalesPrice:
        example: '123412.01'
        type: string
      OwnerName1:
        example: OwnerName1
        type: string
      OwnerName2:
        example: OwnerName2
        type: string
      OwnerName3:
        example: OwnerName3
        type: string
      OwnerName4:
        example: OwnerName4
        type: string
      CurrentOwnerAsOf:
        example: '20171231'
        type: string
      TransactionHistory:
        type: array
        items:
          $ref: '#/definitions/Transaction'
  PropertyPreforeclosureType:
    type: object
    properties:
      StatusCode:
        example: Success
        type: string
      PropertyAddress:
        $ref: '#/definitions/Address'
      Buyers:
        type: array
        items:
          $ref: '#/definitions/EntityInfo'
      Sellers:
        type: array
        items:
          $ref: '#/definitions/EntityInfo'
      RecordingDate:
        example: '20171231'
        type: string
      ForeclosureStatus:
        example: Preforeclosure
        type: string
      TypeofSale:
        example: Refi
        type: string
      OwnerName1:
        example: OwnerName1
        type: string
      OwnerName2:
        example: OwnerName2
        type: string
      OwnerName3:
        example: OwnerName3
        type: string
      OwnerName4:
        example: OwnerName4
        type: string
      CurrentOwnerAsOf:
        example: CurrentOwnerAsOf
        type: string
      TransactionHistory:
        type: array
        items:
          $ref: '#/definitions/Transaction'
  PropertyScheduleREOType:
    type: object
    properties:
      StatusCode:
        example: Success
        type: string
      PropertyAddress:
        $ref: '#/definitions/Address'
      Buyers:
        type: array
        items:
          $ref: '#/definitions/EntityInfo'
      Sellers:
        type: array
        items:
          $ref: '#/definitions/EntityInfo'
      RecordingDate:
        example: '20171231'
        type: string
      ForeclosureStatus:
        example: Preforeclosure
        type: string
      TypeofSale:
        example: Refi
        type: string
      SaleDate:
        example: '20161031'
        type: string
      SalesPrice:
        example: '215292'
        type: string
      LenderName:
        example: Don Draper
        type: string
      LoanAmount:
        example: '215292'
        type: string
      LoanTerms:
        example: 20 Years
        type: string
      LoanType:
        example: Refi
        type: string
      MaturityDate:
        example: '20161031'
        type: string
      LandUse:
        example: Land Use Description
        type: string
      PropertyTaxYear:
        example: '2016'
        type: string
      PropertyTaxAmount:
        example: '3500'
        type: string
      OwnershipStatus:
        example: Previously Foreclosed
        type: string
      OwnerName1:
        example: OwnerName1
        type: string
      OwnerName2:
        example: OwnerName2
        type: string
      OwnerName3:
        example: OwnerName3
        type: string
      OwnerName4:
        example: OwnerName4
        type: string
      FinancingTypeCode:
        example: code
        type: string
      FinancingTypeDesc:
        example: financing desc
        type: string
      OwnerOccupied:
        example: 'True'
        type: string
      Valuations:
        $ref: '#/definitions/AVMInformation'
      MailingAddress:
        $ref: '#/definitions/Address'
      CurrentOwnerAsOf:
        example: '20171231'
        type: string
      TransactionHistory:
        type: array
        items:
          $ref: '#/definitions/Transaction'
  PropertyForeclosureType:
    type: object
    properties:
      StatusCode:
        example: Success
        type: string
      PropertyAddress:
        $ref: '#/definitions/Address'
      Buyers:
        type: array
        items:
          $ref: '#/definitions/EntityInfo'
      Sellers:
        type: array
        items:
          $ref: '#/definitions/EntityInfo'
      RecordingDate:
        example: '20171231'
        type: string
      ForeclosureStatus:
        example: Preforeclosure
        type: string
      TypeofSale:
        example: Refi
        type: string
      SaleDate:
        example: '20161031'
        type: string
      SalesPrice:
        example: '215292'
        type: string
      OwnershipStatus:
        example: Prev

# --- truncated at 32 KB (85 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/first-american-financial/refs/heads/main/openapi/first-american-financial-ownership-openapi.yml