> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anysite.io/llms.txt
> Use this file to discover all available pages before exploring further.

# /midland/transactions

> Get one Hong Kong property deal recorded by Midland Realty by its transaction id (or transaction URL), together with the full price history of the same unit. Returns the transacted price and price per saleable area, gross and saleable area, room counts, floor, floor band, flat and orientation, unit features and floor plans, the eight-level geography, the estate profile (vendor, address, block count, occupation date, coordinates, school nets, facilities, photos and videos), the building, and every earlier deal on the same unit with its price, date, prior price and gain.

**Price:** 1 credit

**⚠️ Common errors:** 412: No deal with this transaction id.



## OpenAPI

````yaml /openapi/real-estate.json post /api/midland/transactions
openapi: 3.1.0
info:
  title: Any Site API
  description: >+
    Any Site API provides programmatic access to data from LinkedIn, Instagram,
    Twitter, and other platforms.


    ## Authentication


    All API endpoints require an `access-token` header with a valid API token.
    Tokens can be created in the [dashboard](https://app.anysite.io/).


    ## Pricing


    Each endpoint has a credit cost listed in its description. Credits are
    deducted from your token balance per request.

  version: 0.0.1
servers: []
security:
  - AccessToken: []
paths:
  /api/midland/transactions:
    post:
      tags:
        - /midland
      summary: /midland/transactions
      description: >-
        Get one Hong Kong property deal recorded by Midland Realty by its
        transaction id (or transaction URL), together with the full price
        history of the same unit. Returns the transacted price and price per
        saleable area, gross and saleable area, room counts, floor, floor band,
        flat and orientation, unit features and floor plans, the eight-level
        geography, the estate profile (vendor, address, block count, occupation
        date, coordinates, school nets, facilities, photos and videos), the
        building, and every earlier deal on the same unit with its price, date,
        prior price and gain.


        **Price:** 1 credit


        **⚠️ Common errors:** 412: No deal with this transaction id.
      operationId: __api_midland_transactions_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MidlandTransactionsPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MidlandTransaction'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    MidlandTransactionsPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          default: 300
        lang:
          $ref: '#/components/schemas/MidlandLang'
          default: zh-hk
        unit:
          $ref: '#/components/schemas/MidlandUnit'
          default: feet
        currency:
          $ref: '#/components/schemas/MidlandCurrency'
          default: HKD
        transaction:
          type: string
      type: object
      required:
        - transaction
    MidlandTransaction:
      properties:
        '@type':
          type: string
          default: MidlandTransaction
        id:
          type: string
        url:
          anyOf:
            - type: string
            - type: 'null'
        url_zh_cn:
          anyOf:
            - type: string
            - type: 'null'
        url_en:
          anyOf:
            - type: string
            - type: 'null'
        transaction_type:
          anyOf:
            - type: string
            - type: 'null'
        transaction_at:
          anyOf:
            - type: integer
            - type: 'null'
        market_type:
          anyOf:
            - type: string
            - type: 'null'
        deal_type:
          anyOf:
            - type: string
            - type: 'null'
        source:
          anyOf:
            - type: string
            - type: 'null'
        original_source:
          anyOf:
            - type: string
            - type: 'null'
        tags:
          items:
            type: string
          type: array
          default: []
        price:
          anyOf:
            - type: number
            - type: 'null'
        price_per_net_area:
          anyOf:
            - type: number
            - type: 'null'
        area:
          anyOf:
            - type: number
            - type: 'null'
        net_area:
          anyOf:
            - type: number
            - type: 'null'
        bedroom_count:
          anyOf:
            - type: integer
            - type: 'null'
        sitting_room_count:
          anyOf:
            - type: integer
            - type: 'null'
        floor:
          anyOf:
            - type: string
            - type: 'null'
        floor_level:
          anyOf:
            - $ref: '#/components/schemas/MidlandRef'
            - type: 'null'
        flat:
          anyOf:
            - type: string
            - type: 'null'
        orientation:
          anyOf:
            - type: string
            - type: 'null'
        geo:
          anyOf:
            - $ref: '#/components/schemas/MidlandGeo'
            - type: 'null'
        estate:
          anyOf:
            - $ref: '#/components/schemas/MidlandTransactionEstate'
            - type: 'null'
        building:
          anyOf:
            - $ref: '#/components/schemas/MidlandBuilding'
            - type: 'null'
        features:
          items:
            $ref: '#/components/schemas/MidlandRef'
          type: array
          default: []
        floor_plans:
          items:
            $ref: '#/components/schemas/MidlandFloorPlan'
          type: array
          default: []
        images:
          items:
            type: string
          type: array
          default: []
        history:
          items:
            $ref: '#/components/schemas/MidlandTransactionHistoryEntry'
          type: array
          default: []
        building_history_url:
          anyOf:
            - type: string
            - type: 'null'
        estate_url:
          anyOf:
            - type: string
            - type: 'null'
        listings_url:
          anyOf:
            - type: string
            - type: 'null'
        news_url:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - id
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    MidlandLang:
      type: string
      enum:
        - zh-hk
        - zh-cn
        - en
    MidlandUnit:
      type: string
      enum:
        - feet
        - meter
    MidlandCurrency:
      type: string
      enum:
        - HKD
        - CNY
    MidlandRef:
      properties:
        '@type':
          type: string
          default: MidlandRef
        id:
          anyOf:
            - type: string
            - type: 'null'
        name:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    MidlandGeo:
      properties:
        '@type':
          type: string
          default: MidlandGeo
        region:
          anyOf:
            - $ref: '#/components/schemas/MidlandRef'
            - type: 'null'
        subregion:
          anyOf:
            - $ref: '#/components/schemas/MidlandRef'
            - type: 'null'
        district:
          anyOf:
            - $ref: '#/components/schemas/MidlandRef'
            - type: 'null'
        sm_district:
          anyOf:
            - $ref: '#/components/schemas/MidlandRef'
            - type: 'null'
        combined_district:
          anyOf:
            - $ref: '#/components/schemas/MidlandRef'
            - type: 'null'
        int_district:
          anyOf:
            - $ref: '#/components/schemas/MidlandRef'
            - type: 'null'
        int_sm_district:
          anyOf:
            - $ref: '#/components/schemas/MidlandRef'
            - type: 'null'
        lux_district:
          anyOf:
            - $ref: '#/components/schemas/MidlandRef'
            - type: 'null'
      type: object
    MidlandTransactionEstate:
      properties:
        '@type':
          type: string
          default: MidlandTransactionEstate
        id:
          anyOf:
            - type: string
            - type: 'null'
        name:
          anyOf:
            - type: string
            - type: 'null'
        address:
          anyOf:
            - type: string
            - type: 'null'
        vendor:
          anyOf:
            - type: string
            - type: 'null'
        block_count_text:
          anyOf:
            - type: string
            - type: 'null'
        first_op_at:
          anyOf:
            - type: integer
            - type: 'null'
        latitude:
          anyOf:
            - type: number
            - type: 'null'
        longitude:
          anyOf:
            - type: number
            - type: 'null'
        school_net:
          anyOf:
            - $ref: '#/components/schemas/MidlandSchoolNet'
            - type: 'null'
        facility_groups:
          items:
            $ref: '#/components/schemas/MidlandRef'
          type: array
          default: []
        property_status:
          items:
            type: string
          type: array
          default: []
        photos:
          items:
            type: string
          type: array
          default: []
        videos:
          items:
            $ref: '#/components/schemas/MidlandPropertyVideo'
          type: array
          default: []
        url:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    MidlandBuilding:
      properties:
        '@type':
          type: string
          default: MidlandBuilding
        id:
          anyOf:
            - type: string
            - type: 'null'
        name:
          anyOf:
            - type: string
            - type: 'null'
        address:
          anyOf:
            - type: string
            - type: 'null'
        first_op_at:
          anyOf:
            - type: integer
            - type: 'null'
        floor_count:
          anyOf:
            - type: integer
            - type: 'null'
        building_type:
          anyOf:
            - type: string
            - type: 'null'
        latitude:
          anyOf:
            - type: number
            - type: 'null'
        longitude:
          anyOf:
            - type: number
            - type: 'null'
        streetview_latitude:
          anyOf:
            - type: number
            - type: 'null'
        streetview_longitude:
          anyOf:
            - type: number
            - type: 'null'
        streetview_angle:
          anyOf:
            - type: integer
            - type: 'null'
      type: object
    MidlandFloorPlan:
      properties:
        '@type':
          type: string
          default: MidlandFloorPlan
        id:
          anyOf:
            - type: string
            - type: 'null'
        name:
          anyOf:
            - type: string
            - type: 'null'
        url:
          anyOf:
            - type: string
            - type: 'null'
        source:
          anyOf:
            - type: string
            - type: 'null'
        phase_id:
          anyOf:
            - type: string
            - type: 'null'
        phase_name:
          anyOf:
            - type: string
            - type: 'null'
        building_id:
          anyOf:
            - type: string
            - type: 'null'
        building_name:
          anyOf:
            - type: string
            - type: 'null'
        floor_from:
          anyOf:
            - type: string
            - type: 'null'
        floor_to:
          anyOf:
            - type: string
            - type: 'null'
        floor_text:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    MidlandTransactionHistoryEntry:
      properties:
        '@type':
          type: string
          default: MidlandTransactionHistoryEntry
        id:
          anyOf:
            - type: string
            - type: 'null'
        transaction_at:
          anyOf:
            - type: integer
            - type: 'null'
        transaction_type:
          anyOf:
            - type: string
            - type: 'null'
        market_type:
          anyOf:
            - type: string
            - type: 'null'
        price:
          anyOf:
            - type: number
            - type: 'null'
        area:
          anyOf:
            - type: number
            - type: 'null'
        net_area:
          anyOf:
            - type: number
            - type: 'null'
        previous_price:
          anyOf:
            - type: number
            - type: 'null'
        previous_transaction_at:
          anyOf:
            - type: integer
            - type: 'null'
        gain_percent:
          anyOf:
            - type: number
            - type: 'null'
        bedroom_count:
          anyOf:
            - type: integer
            - type: 'null'
        sitting_room_count:
          anyOf:
            - type: integer
            - type: 'null'
        floor:
          anyOf:
            - type: string
            - type: 'null'
        flat:
          anyOf:
            - type: string
            - type: 'null'
        estate:
          anyOf:
            - $ref: '#/components/schemas/MidlandRef'
            - type: 'null'
        building:
          anyOf:
            - $ref: '#/components/schemas/MidlandBuilding'
            - type: 'null'
        source:
          anyOf:
            - type: string
            - type: 'null'
        original_source:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
        msg:
          type: string
        type:
          type: string
        input: {}
        ctx:
          type: object
      type: object
      required:
        - loc
        - msg
        - type
    MidlandSchoolNet:
      properties:
        '@type':
          type: string
          default: MidlandSchoolNet
        kindergarten_id:
          anyOf:
            - type: string
            - type: 'null'
        kindergarten_name:
          anyOf:
            - type: string
            - type: 'null'
        primary_id:
          anyOf:
            - type: string
            - type: 'null'
        primary_name:
          anyOf:
            - type: string
            - type: 'null'
        secondary_id:
          anyOf:
            - type: string
            - type: 'null'
        secondary_name:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    MidlandPropertyVideo:
      properties:
        '@type':
          type: string
          default: MidlandPropertyVideo
        id:
          anyOf:
            - type: string
            - type: 'null'
        url:
          anyOf:
            - type: string
            - type: 'null'
        stream_url:
          anyOf:
            - type: string
            - type: 'null'
        thumbnail:
          anyOf:
            - type: string
            - type: 'null'
      type: object
  securitySchemes:
    AccessToken:
      type: apiKey
      in: header
      name: access-token
      description: API token from the dashboard

````