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

# Read a market data result

> Read normalized output, delivery status, and total charges for an existing market data request. Follow the result_url returned by the call.

Use `result_url` unchanged on the API origin and authenticate with a Key permitted to read every Run. The response uses the same fields as the initial Solution response. HTTP 200 can still carry `result_status: pending`; keep polling until `status` is terminal. This read creates no Runs, calls no Providers and does not resume fallback.


## OpenAPI

````yaml /openapi.json get /v1/solutions/gtm/market_data/result
openapi: 3.1.0
info:
  title: Glasser
  version: 0.0.1
  description: >-
    One key, no contract, pay per call, across paid APIs bought wholesale. Every
    response carries x-request-id; every error body carries the same envelope.
servers:
  - url: https://api.glasser.ai
security: []
tags:
  - name: Solutions
  - name: Endpoints
  - name: Runs
  - name: Balance
paths:
  /v1/solutions/gtm/market_data/result:
    get:
      tags:
        - Solutions
      summary: Read a market data result
      description: >-
        Follow result_url from a market data call to read normalized output,
        business result_status and the total charge of the same Runs. HTTP 200
        may still contain result_status=pending. This authenticated read creates
        no Runs, calls no Providers and does not resume fallback. GET
        /v1/runs/:id remains the native individual Run. The result context is
        signed, bound to the Workspace and checked against the current Key
        policy for every Run.
      operationId: gtm-market-data-result
      parameters:
        - name: token
          in: query
          schema:
            type: string
            minLength: 1
            maxLength: 16384
            description: >-
              Opaque result context returned in result_url. Keep it unchanged
              and authenticate with a Key permitted to read every listed Run.
          required: true
      responses:
        '200':
          description: MarketDataResult
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarketDataResult'
        '400':
          description: ValidationFailed
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/ValidationFailedEncoded'
                  - $ref: '#/components/schemas/ValidationFailedEncoded'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedEncoded'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenEncoded'
        '404':
          description: NotFound
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundEncoded'
        '429':
          description: RateLimited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitedEncoded'
      security:
        - bearer: []
components:
  schemas:
    MarketDataResult:
      type: object
      properties:
        id:
          type: string
        run_url:
          type: string
          description: Open this Run in the console. Requires Workspace membership.
        provider:
          type: string
          pattern: ^[a-z0-9][a-z0-9-]*$
        endpoint:
          type: string
          pattern: ^\/.+$
        endpoint_version:
          type: integer
          exclusiveMinimum: 0
        status:
          type: string
          enum:
            - QUEUED
            - RUNNING
            - COMPLETED
            - FAILED
            - STOPPED
          description: >-
            QUEUED or RUNNING: still in progress. COMPLETED: a Provider response
            is available, including non-2xx responses. FAILED: read failure.
            STOPPED: stopped before dispatch. Read charge_usd separately from
            status.
        failure:
          anyOf:
            - type: object
              properties:
                kind:
                  type: string
                  enum:
                    - TIMED_OUT
                    - INTERNAL
                message:
                  type: string
              required:
                - kind
                - message
              additionalProperties: false
            - type: 'null'
          description: Why the Run failed. Non-null only when status is FAILED.
        input:
          type: object
        output:
          anyOf:
            - anyOf:
                - type: object
                  properties:
                    address:
                      anyOf:
                        - type: string
                        - type: 'null'
                    property_type:
                      anyOf:
                        - type: string
                        - type: 'null'
                    bedrooms:
                      anyOf:
                        - anyOf:
                            - type: number
                            - type: string
                              enum:
                                - Infinity
                                - '-Infinity'
                                - NaN
                        - type: 'null'
                    bathrooms:
                      anyOf:
                        - anyOf:
                            - type: number
                            - type: string
                              enum:
                                - Infinity
                                - '-Infinity'
                                - NaN
                        - type: 'null'
                    living_area_sqft:
                      anyOf:
                        - type: integer
                        - type: 'null'
                    lot_size_sqft:
                      anyOf:
                        - type: integer
                        - type: 'null'
                    year_built:
                      anyOf:
                        - type: integer
                        - type: 'null'
                    latitude:
                      anyOf:
                        - anyOf:
                            - type: number
                            - type: string
                              enum:
                                - Infinity
                                - '-Infinity'
                                - NaN
                        - type: 'null'
                    longitude:
                      anyOf:
                        - anyOf:
                            - type: number
                            - type: string
                              enum:
                                - Infinity
                                - '-Infinity'
                                - NaN
                        - type: 'null'
                    estimated_value_usd:
                      anyOf:
                        - anyOf:
                            - type: number
                            - type: string
                              enum:
                                - Infinity
                                - '-Infinity'
                                - NaN
                        - type: 'null'
                    value_low_usd:
                      anyOf:
                        - anyOf:
                            - type: number
                            - type: string
                              enum:
                                - Infinity
                                - '-Infinity'
                                - NaN
                        - type: 'null'
                    value_high_usd:
                      anyOf:
                        - anyOf:
                            - type: number
                            - type: string
                              enum:
                                - Infinity
                                - '-Infinity'
                                - NaN
                        - type: 'null'
                    comparables_count:
                      anyOf:
                        - type: integer
                        - type: 'null'
                  required:
                    - address
                    - property_type
                    - bedrooms
                    - bathrooms
                    - living_area_sqft
                    - lot_size_sqft
                    - year_built
                    - latitude
                    - longitude
                    - estimated_value_usd
                    - value_low_usd
                    - value_high_usd
                    - comparables_count
                  additionalProperties: false
                - type: object
                  properties:
                    address:
                      anyOf:
                        - type: string
                        - type: 'null'
                    property_type:
                      anyOf:
                        - type: string
                        - type: 'null'
                    bedrooms:
                      anyOf:
                        - anyOf:
                            - type: number
                            - type: string
                              enum:
                                - Infinity
                                - '-Infinity'
                                - NaN
                        - type: 'null'
                    bathrooms:
                      anyOf:
                        - anyOf:
                            - type: number
                            - type: string
                              enum:
                                - Infinity
                                - '-Infinity'
                                - NaN
                        - type: 'null'
                    living_area_sqft:
                      anyOf:
                        - type: integer
                        - type: 'null'
                    lot_size_sqft:
                      anyOf:
                        - type: integer
                        - type: 'null'
                    year_built:
                      anyOf:
                        - type: integer
                        - type: 'null'
                    latitude:
                      anyOf:
                        - anyOf:
                            - type: number
                            - type: string
                              enum:
                                - Infinity
                                - '-Infinity'
                                - NaN
                        - type: 'null'
                    longitude:
                      anyOf:
                        - anyOf:
                            - type: number
                            - type: string
                              enum:
                                - Infinity
                                - '-Infinity'
                                - NaN
                        - type: 'null'
                    estimated_rent_usd:
                      anyOf:
                        - anyOf:
                            - type: number
                            - type: string
                              enum:
                                - Infinity
                                - '-Infinity'
                                - NaN
                        - type: 'null'
                    rent_low_usd:
                      anyOf:
                        - anyOf:
                            - type: number
                            - type: string
                              enum:
                                - Infinity
                                - '-Infinity'
                                - NaN
                        - type: 'null'
                    rent_high_usd:
                      anyOf:
                        - anyOf:
                            - type: number
                            - type: string
                              enum:
                                - Infinity
                                - '-Infinity'
                                - NaN
                        - type: 'null'
                    comparables_count:
                      anyOf:
                        - type: integer
                        - type: 'null'
                  required:
                    - address
                    - property_type
                    - bedrooms
                    - bathrooms
                    - living_area_sqft
                    - lot_size_sqft
                    - year_built
                    - latitude
                    - longitude
                    - estimated_rent_usd
                    - rent_low_usd
                    - rent_high_usd
                    - comparables_count
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          property_id:
                            anyOf:
                              - type: string
                              - type: 'null'
                          address:
                            anyOf:
                              - type: string
                              - type: 'null'
                          property_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          bedrooms:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                          bathrooms:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                          living_area_sqft:
                            anyOf:
                              - type: integer
                              - type: 'null'
                          lot_size_sqft:
                            anyOf:
                              - type: integer
                              - type: 'null'
                          year_built:
                            anyOf:
                              - type: integer
                              - type: 'null'
                          latitude:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                          longitude:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                          last_sale_price_usd:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                          last_sale_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          owner_names:
                            anyOf:
                              - type: array
                                items:
                                  type: string
                              - type: 'null'
                          owner_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          owner_mailing_address:
                            anyOf:
                              - type: string
                              - type: 'null'
                          owner_occupied:
                            anyOf:
                              - type: boolean
                              - type: 'null'
                        required:
                          - property_id
                          - address
                          - property_type
                          - bedrooms
                          - bathrooms
                          - living_area_sqft
                          - lot_size_sqft
                          - year_built
                          - latitude
                          - longitude
                          - last_sale_price_usd
                          - last_sale_date
                          - owner_names
                          - owner_type
                          - owner_mailing_address
                          - owner_occupied
                        additionalProperties: false
                  required:
                    - items
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          listing_id:
                            anyOf:
                              - type: string
                              - type: 'null'
                          address:
                            anyOf:
                              - type: string
                              - type: 'null'
                          property_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          bedrooms:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                          bathrooms:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                          living_area_sqft:
                            anyOf:
                              - type: integer
                              - type: 'null'
                          lot_size_sqft:
                            anyOf:
                              - type: integer
                              - type: 'null'
                          year_built:
                            anyOf:
                              - type: integer
                              - type: 'null'
                          latitude:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                          longitude:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                          status:
                            anyOf:
                              - type: string
                              - type: 'null'
                          listing_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          listed_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          days_on_market:
                            anyOf:
                              - type: integer
                              - type: 'null'
                          hoa_fee_usd:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                          mls_name:
                            anyOf:
                              - type: string
                              - type: 'null'
                          mls_number:
                            anyOf:
                              - type: string
                              - type: 'null'
                          agent:
                            anyOf:
                              - type: object
                                properties:
                                  name:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  phone:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  email:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  website:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                required:
                                  - name
                                  - phone
                                  - email
                                  - website
                                additionalProperties: false
                              - type: 'null'
                          office:
                            anyOf:
                              - type: object
                                properties:
                                  name:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  phone:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  email:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  website:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                required:
                                  - name
                                  - phone
                                  - email
                                  - website
                                additionalProperties: false
                              - type: 'null'
                          price_usd:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                        required:
                          - listing_id
                          - address
                          - property_type
                          - bedrooms
                          - bathrooms
                          - living_area_sqft
                          - lot_size_sqft
                          - year_built
                          - latitude
                          - longitude
                          - status
                          - listing_type
                          - listed_date
                          - days_on_market
                          - hoa_fee_usd
                          - mls_name
                          - mls_number
                          - agent
                          - office
                          - price_usd
                        additionalProperties: false
                  required:
                    - items
                  additionalProperties: false
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        type: object
                        properties:
                          listing_id:
                            anyOf:
                              - type: string
                              - type: 'null'
                          address:
                            anyOf:
                              - type: string
                              - type: 'null'
                          property_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          bedrooms:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                          bathrooms:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                          living_area_sqft:
                            anyOf:
                              - type: integer
                              - type: 'null'
                          lot_size_sqft:
                            anyOf:
                              - type: integer
                              - type: 'null'
                          year_built:
                            anyOf:
                              - type: integer
                              - type: 'null'
                          latitude:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                          longitude:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                          status:
                            anyOf:
                              - type: string
                              - type: 'null'
                          listing_type:
                            anyOf:
                              - type: string
                              - type: 'null'
                          listed_date:
                            anyOf:
                              - type: string
                              - type: 'null'
                          days_on_market:
                            anyOf:
                              - type: integer
                              - type: 'null'
                          hoa_fee_usd:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                          mls_name:
                            anyOf:
                              - type: string
                              - type: 'null'
                          mls_number:
                            anyOf:
                              - type: string
                              - type: 'null'
                          agent:
                            anyOf:
                              - type: object
                                properties:
                                  name:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  phone:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  email:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  website:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                required:
                                  - name
                                  - phone
                                  - email
                                  - website
                                additionalProperties: false
                              - type: 'null'
                          office:
                            anyOf:
                              - type: object
                                properties:
                                  name:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  phone:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  email:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                  website:
                                    anyOf:
                                      - type: string
                                      - type: 'null'
                                required:
                                  - name
                                  - phone
                                  - email
                                  - website
                                additionalProperties: false
                              - type: 'null'
                          monthly_rent_usd:
                            anyOf:
                              - anyOf:
                                  - type: number
                                  - type: string
                                    enum:
                                      - Infinity
                                      - '-Infinity'
                                      - NaN
                              - type: 'null'
                        required:
                          - listing_id
                          - address
                          - property_type
                          - bedrooms
                          - bathrooms
                          - living_area_sqft
                          - lot_size_sqft
                          - year_built
                          - latitude
                          - longitude
                          - status
                          - listing_type
                          - listed_date
                          - days_on_market
                          - hoa_fee_usd
                          - mls_name
                          - mls_number
                          - agent
                          - office
                          - monthly_rent_usd
                        additionalProperties: false
                  required:
                    - items
                  additionalProperties: false
                - type: object
                  properties:
                    zip:
                      anyOf:
                        - type: string
                        - type: 'null'
                    updated_at:
                      anyOf:
                        - type: string
                        - type: 'null'
                    sale:
                      anyOf:
                        - type: object
                          properties:
                            average_price_usd:
                              anyOf:
                                - anyOf:
                                    - type: number
                                    - type: string
                                      enum:
                                        - Infinity
                                        - '-Infinity'
                                        - NaN
                                - type: 'null'
                            median_price_usd:
                              anyOf:
                                - anyOf:
                                    - type: number
                                    - type: string
                                      enum:
                                        - Infinity
                                        - '-Infinity'
                                        - NaN
                                - type: 'null'
                            average_price_per_sqft_usd:
                              anyOf:
                                - anyOf:
                                    - type: number
                                    - type: string
                                      enum:
                                        - Infinity
                                        - '-Infinity'
                                        - NaN
                                - type: 'null'
                            median_price_per_sqft_usd:
                              anyOf:
                                - anyOf:
                                    - type: number
                                    - type: string
                                      enum:
                                        - Infinity
                                        - '-Infinity'
                                        - NaN
                                - type: 'null'
                            average_days_on_market:
                              anyOf:
                                - anyOf:
                                    - type: number
                                    - type: string
                                      enum:
                                        - Infinity
                                        - '-Infinity'
                                        - NaN
                                - type: 'null'
                            median_days_on_market:
                              anyOf:
                                - anyOf:
                                    - type: number
                                    - type: string
                                      enum:
                                        - Infinity
                                        - '-Infinity'
                                        - NaN
                                - type: 'null'
                            total_listings:
                              anyOf:
                                - type: integer
                                - type: 'null'
                            new_listings:
                              anyOf:
                                - type: integer
                                - type: 'null'
                          required:
                            - average_price_usd
                            - median_price_usd
                            - average_price_per_sqft_usd
                            - median_price_per_sqft_usd
                            - average_days_on_market
                            - median_days_on_market
                            - total_listings
                            - new_listings
                          additionalProperties: false
                        - type: 'null'
                    rental:
                      anyOf:
                        - type: object
                          properties:
                            average_rent_usd:
                              anyOf:
                                - anyOf:
                                    - type: number
                                    - type: string
                                      enum:
                                        - Infinity
                                        - '-Infinity'
                                        - NaN
                                - type: 'null'
                            median_rent_usd:
                              anyOf:
                                - anyOf:
                                    - type: number
                                    - type: string
                                      enum:
                                        - Infinity
                                        - '-Infinity'
                                        - NaN
                                - type: 'null'
                            average_rent_per_sqft_usd:
                              anyOf:
                                - anyOf:
                                    - type: number
                                    - type: string
                                      enum:
                                        - Infinity
                                        - '-Infinity'
                                        - NaN
                                - type: 'null'
                            median_rent_per_sqft_usd:
                              anyOf:
                                - anyOf:
                                    - type: number
                                    - type: string
                                      enum:
                                        - Infinity
                                        - '-Infinity'
                                        - NaN
                                - type: 'null'
                            average_days_on_market:
                              anyOf:
                                - anyOf:
                                    - type: number
                                    - type: string
                                      enum:
                                        - Infinity
                                        - '-Infinity'
                                        - NaN
                                - type: 'null'
                            median_days_on_market:
                              anyOf:
                                - anyOf:
                                    - type: number
                                    - type: string
                                      enum:
                                        - Infinity
                                        - '-Infinity'
                                        - NaN
                                - type: 'null'
                            total_listings:
                              anyOf:
                                - type: integer
                                - type: 'null'
                            new_listings:
                              anyOf:
                                - type: integer
                                - type: 'null'
                          required:
                            - average_rent_usd
                            - median_rent_usd
                            - average_rent_per_sqft_usd
                            - median_rent_per_sqft_usd
                            - average_days_on_market
                            - median_days_on_market
                            - total_listings
                            - new_listings
                          additionalProperties: false
                        - type: 'null'
                  required:
                    - zip
                    - updated_at
                    - sale
                    - rental
                  additionalProperties: false
                - type: object
                  properties:
                    symbol:
                      anyOf:
                        - type: string
                        - type: 'null'
                    name:
                      anyOf:
                        - type: string
                        - type: 'null'
                    exchange:
                      anyOf:
                        - type: string
                        - type: 'null'
                    currency:
                      anyOf:
                        - type: string
                        - type: 'null'
                    price:
                      anyOf:
                        - anyOf:
                            - type: number
                            - type: string
                              enum:
                                - Infinity
                                - '-Infinity'
                                - NaN
                        - type: 'null'
                    change:
                      anyOf:
                        - anyOf:
                            - type: number
                            - type: string
                              enum:
                                - Infinity
                                - '-Infinity'
                                - NaN
                        - type: 'null'
                    change_percent:
                      anyOf:
                        - anyOf:
                            - type: number
                            - type: string
                              enum:
                                - Infinity
                                - '-Infinity'
                                - NaN
                        - type: 'null'
                    extended_hours_session:
                      anyOf:
                        - type: string
                        - type: 'null'
                    extended_hours_price:
                      anyOf:
                        - anyOf:
                            - type: number
                            - type: string
                              enum:
                                - Infinity
                                - '-Infinity'
                                - NaN
                        - type: 'null'
                    extended_hours_change:
                      anyOf:
                        - anyOf:
                            - type: number
                            - type: string
                              enum:
                                - Infinity
                                - '-Infinity'
                                - NaN
                        - type: 'null'
                    extended_hours_change_percent:
                      anyOf:
                        - anyOf:
                            - type: number
                            - type: string
                              enum:
                                - Infinity
                                - '-Infinity'
                                - NaN
                        - type: 'null'
                    as_of_text:
                      anyOf:
                        - type: string
                        - type: 'null'
                  required:
                    - symbol
                    - name
                    - exchange
                    - currency
                    - price
                    - change
                    - change_percent
                    - extended_hours_session
                    - extended_hours_price
                    - extended_hours_change
                    - extended_hours_change_percent
                    - as_of_text
                  additionalProperties: false
            - type: 'null'
          description: >-
            Normalized fields per action. The Provider's native output is not
            repeated here; it stays on the Run (GET /v1/runs/:id). Values a
            Provider does not report are null; an empty answer keeps the
            action's shape with every field null (or items: []) and
            result_status no_result. Money is USD unless the action carries a
            currency field. Dates named *_date are YYYY-MM-DD, *_at are ISO 8601
            UTC, and *_text is display text exactly as returned.


            - property_value: address, property_type, bedrooms, bathrooms,
            living_area_sqft (living area), lot_size_sqft, year_built, latitude,
            longitude, estimated_value_usd, value_low_usd, value_high_usd,
            comparables_count (number of comparable sales behind the estimate)

            - property_rent: address, property_type, bedrooms, bathrooms,
            living_area_sqft (living area), lot_size_sqft, year_built, latitude,
            longitude, estimated_rent_usd (monthly), rent_low_usd,
            rent_high_usd, comparables_count (number of comparable rentals
            behind the estimate)

            - property_search: items[]: property_id, address, property_type,
            bedrooms, bathrooms, living_area_sqft (living area), lot_size_sqft,
            year_built, latitude, longitude, last_sale_price_usd, last_sale_date
            (YYYY-MM-DD), owner_names[], owner_type, owner_mailing_address,
            owner_occupied

            - listings_sale: items[]: listing_id, address, property_type,
            bedrooms, bathrooms, living_area_sqft (living area), lot_size_sqft,
            year_built, latitude, longitude, status, listing_type, listed_date
            (YYYY-MM-DD), days_on_market, hoa_fee_usd (monthly HOA fee),
            mls_name, mls_number, agent {name, phone, email, website}, office
            {name, phone, email, website}, price_usd (asking price)

            - listings_rental: items[]: listing_id, address, property_type,
            bedrooms, bathrooms, living_area_sqft (living area), lot_size_sqft,
            year_built, latitude, longitude, status, listing_type, listed_date
            (YYYY-MM-DD), days_on_market, hoa_fee_usd (monthly HOA fee),
            mls_name, mls_number, agent {name, phone, email, website}, office
            {name, phone, email, website}, monthly_rent_usd

            - market_stats: zip, updated_at (ISO 8601 UTC, when RentCast last
            refreshed the aggregate), sale {average_price_usd, median_price_usd,
            average_price_per_sqft_usd, median_price_per_sqft_usd,
            average_days_on_market, median_days_on_market, total_listings,
            new_listings}, rental {average_rent_usd, median_rent_usd,
            average_rent_per_sqft_usd, median_rent_per_sqft_usd (monthly rent),
            average_days_on_market, median_days_on_market, total_listings,
            new_listings}

            - stock_quote: symbol, name, exchange, currency, price
            (regular-session last price, in currency; Google Finance quotes may
            be delayed), change (absolute, in currency, vs the previous regular
            close), change_percent (percent points vs the previous regular
            close: 1.5 = 1.5%), extended_hours_session (the session label as
            shown, e.g. Pre-market or After hours; null during regular hours),
            extended_hours_price, extended_hours_change and
            extended_hours_change_percent (the extended-hours quote vs the
            regular-session price, same units), as_of_text (the Google Finance
            page timestamp exactly as shown, not ISO and not the time of price)
        provider_response:
          anyOf:
            - type: object
              properties:
                http_status:
                  type: integer
                  minimum: 100
                  maximum: 599
                  description: >-
                    HTTP status returned by the Provider. Check this even when
                    the Run is COMPLETED.
                error:
                  anyOf:
                    - {}
                    - type: 'null'
              required:
                - http_status
              additionalProperties: false
            - type: 'null'
          description: >-
            Non-null only when status is COMPLETED.


            - For 2xx responses, output contains Provider-native JSON (any
            shape), or null for an empty body.

            - For non-2xx responses, error contains the Provider's error body
            and output is null.


            Sensitive fields are removed from both bodies.
        charge_usd:
          anyOf:
            - type: string
              pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
              description: >-
                Exact USD decimal string (min 2, max 6 decimals, one canonical
                spelling). Sum with decimal arithmetic or scale by 10^6 — never
                floats.
            - type: 'null'
          description: >-
            Total charge of runs in this Solution response. Null until all
            listed Runs settle. Each Run retains its own charge; failures can
            also be charged.
        charge_basis:
          anyOf:
            - type: object
              properties:
                clause:
                  type: string
                  enum:
                    - rule
                    - NO_RESULT
                    - PROVIDER_ERROR
                    - TIMED_OUT
                    - INTERNAL
                quantity:
                  anyOf:
                    - type: integer
                      minimum: 0
                    - type: 'null'
              required:
                - clause
                - quantity
              additionalProperties: false
            - type: 'null'
          description: >-
            Single-Run charge basis, or null for a multi-Run total. Read
            runs[].charge_basis for each charge.
        stoppable:
          type: boolean
          description: >-
            Whether a stop request can currently be accepted. This does not
            guarantee that the Run can stop before dispatch.
        stop_requested_at:
          anyOf:
            - type: string
              description: ISO-8601 UTC timestamp
              format: date-time
            - type: 'null'
          description: >-
            When a stop was requested. The Run can still continue if dispatch
            had already started.
        created_at:
          type: string
          description: ISO-8601 UTC timestamp
          format: date-time
        started_at:
          anyOf:
            - type: string
              description: ISO-8601 UTC timestamp
              format: date-time
            - type: 'null'
        completed_at:
          anyOf:
            - type: string
              description: ISO-8601 UTC timestamp
              format: date-time
            - type: 'null'
        task_id:
          anyOf:
            - type: string
            - type: 'null'
        metadata:
          type: object
          additionalProperties:
            type: string
            minLength: 1
            maxLength: 500
          maxProperties: 20
          propertyNames:
            type: string
            pattern: ^[a-z][a-z0-9_]{0,39}$
          description: >-
            Your stored tracking fields. Use them to filter Runs. They never go
            to the Provider or affect routing, Price, or idempotency.


            - Up to 20 keys: lowercase letters, digits, and underscores; start
            with a letter; at most 40 characters.

            - Values: strings of 1–500 characters.

            - user_id: your End user's opaque ID, never their email address or
            name.
        action:
          type: string
          enum:
            - property_value
            - property_rent
            - property_search
            - listings_sale
            - listings_rental
            - market_stats
            - stock_quote
        result_status:
          type: string
          enum:
            - success
            - no_result
            - error
            - pending
          description: >-
            Business delivery status, independent of the final Run lifecycle in
            status. no_result is an empty but valid answer; error means the
            Provider output could not be delivered.
        error:
          anyOf:
            - type: object
              properties:
                code:
                  type: string
                message:
                  type: string
              required:
                - code
                - message
              additionalProperties: false
            - type: 'null'
        runs:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              run_url:
                type: string
                description: Open this Run in the console. Requires Workspace membership.
              provider:
                type: string
                pattern: ^[a-z0-9][a-z0-9-]*$
              endpoint:
                type: string
                pattern: ^\/.+$
              endpoint_version:
                type: integer
                exclusiveMinimum: 0
              status:
                type: string
                enum:
                  - QUEUED
                  - RUNNING
                  - COMPLETED
                  - FAILED
                  - STOPPED
                description: >-
                  QUEUED or RUNNING: still in progress. COMPLETED: a Provider
                  response is available, including non-2xx responses. FAILED:
                  read failure. STOPPED: stopped before dispatch. Read
                  charge_usd separately from status.
              failure:
                anyOf:
                  - type: object
                    properties:
                      kind:
                        type: string
                        enum:
                          - TIMED_OUT
                          - INTERNAL
                      message:
                        type: string
                    required:
                      - kind
                      - message
                    additionalProperties: false
                  - type: 'null'
                description: Why the Run failed. Non-null only when status is FAILED.
              input:
                type: object
                properties:
                  omitted:
                    type: boolean
                    enum:
                      - true
                required:
                  - omitted
                additionalProperties: false
              output:
                type: object
                properties:
                  omitted:
                    type: boolean
                    enum:
                      - true
                required:
                  - omitted
                additionalProperties: false
              provider_response:
                anyOf:
                  - type: object
                    properties:
                      http_status:
                        type: integer
                        minimum: 100
                        maximum: 599
                        description: >-
                          HTTP status returned by the Provider. Check this even
                          when the Run is COMPLETED.
                    required:
                      - http_status
                    additionalProperties: false
                  - type: 'null'
              charge_usd:
                anyOf:
                  - type: string
                    pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
                    description: >-
                      Exact USD decimal string (min 2, max 6 decimals, one
                      canonical spelling). Sum with decimal arithmetic or scale
                      by 10^6 — never floats.
                  - type: 'null'
                description: >-
                  Final charge as an exact USD decimal string. Null while QUEUED
                  or RUNNING. A FAILED Run can have a non-zero charge under the
                  Endpoint's Price.
              charge_basis:
                anyOf:
                  - type: object
                    properties:
                      clause:
                        type: string
                        enum:
                          - rule
                          - NO_RESULT
                          - PROVIDER_ERROR
                          - TIMED_OUT
                          - INTERNAL
                      quantity:
                        anyOf:
                          - type: integer
                            minimum: 0
                          - type: 'null'
                    required:
                      - clause
                      - quantity
                    additionalProperties: false
                  - type: 'null'
                description: >-
                  Price clause used to calculate the charge. Null before
                  settlement or when no Provider attempt was made.
              stoppable:
                type: boolean
                description: >-
                  Whether a stop request can currently be accepted. This does
                  not guarantee that the Run can stop before dispatch.
              stop_requested_at:
                anyOf:
                  - type: string
                    description: ISO-8601 UTC timestamp
                    format: date-time
                  - type: 'null'
                description: >-
                  When a stop was requested. The Run can still continue if
                  dispatch had already started.
              created_at:
                type: string
                description: ISO-8601 UTC timestamp
                format: date-time
              started_at:
                anyOf:
                  - type: string
                    description: ISO-8601 UTC timestamp
                    format: date-time
                  - type: 'null'
              completed_at:
                anyOf:
                  - type: string
                    description: ISO-8601 UTC timestamp
                    format: date-time
                  - type: 'null'
              task_id:
                anyOf:
                  - type: string
                  - type: 'null'
              metadata:
                type: object
                additionalProperties:
                  type: string
                  minLength: 1
                  maxLength: 500
                maxProperties: 20
                propertyNames:
                  type: string
                  pattern: ^[a-z][a-z0-9_]{0,39}$
                description: >-
                  Your stored tracking fields. Use them to filter Runs. They
                  never go to the Provider or affect routing, Price, or
                  idempotency.


                  - Up to 20 keys: lowercase letters, digits, and underscores;
                  start with a letter; at most 40 characters.

                  - Values: strings of 1–500 characters.

                  - user_id: your End user's opaque ID, never their email
                  address or name.
            required:
              - id
              - run_url
              - provider
              - endpoint
              - endpoint_version
              - status
              - failure
              - input
              - output
              - provider_response
              - charge_usd
              - charge_basis
              - stoppable
              - stop_requested_at
              - created_at
              - started_at
              - completed_at
              - task_id
              - metadata
            additionalProperties: false
        result_url:
          type: string
          description: >-
            Authenticated, read-only URL path for polling this normalized result
            and total charge. Use with the API origin. Does not create Runs or
            resume fallback. GET /v1/runs/:id still returns the native,
            individual Run.
      required:
        - id
        - run_url
        - provider
        - endpoint
        - endpoint_version
        - status
        - failure
        - input
        - output
        - provider_response
        - charge_usd
        - charge_basis
        - stoppable
        - stop_requested_at
        - created_at
        - started_at
        - completed_at
        - task_id
        - metadata
        - action
        - result_status
        - error
        - runs
        - result_url
      additionalProperties: false
    ValidationFailedEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - validation_failed
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    UnauthorizedEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - unauthorized
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    ForbiddenEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - forbidden
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    NotFoundEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - not_found
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
    RateLimitedEncoded:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - rate_limited
            message:
              type: string
            reason:
              anyOf:
                - type: string
                - type: 'null'
            control:
              anyOf:
                - type: string
                - type: 'null'
            retry_after_ms:
              anyOf:
                - anyOf:
                    - type: integer
                    - type: 'null'
                - type: 'null'
            details:
              anyOf:
                - type: object
                - type: 'null'
          required:
            - code
            - message
          additionalProperties: false
        request_id:
          type: string
      required:
        - error
        - request_id
      additionalProperties: false
  securitySchemes:
    bearer:
      type: http
      scheme: Bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.