> ## 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.

# Leer un resultado de datos de mercado

> Lee el resultado normalizado, el estado de entrega y los cargos totales de una solicitud existente de datos de mercado. Sigue el result_url que devuelve la llamada.

Usa `result_url` sin modificar en el origen de la API y autentícate con una Key autorizada para leer todos los Runs. La respuesta utiliza los mismos campos que la respuesta inicial de la Solution. HTTP 200 aún puede incluir `result_status: pending`; sigue consultando hasta que `status` sea terminal. Esta lectura no crea Runs, no llama a proveedores de datos y no reanuda el fallback.


## OpenAPI

````yaml /openapi.es.json get /v1/solutions/gtm/market_data/result
openapi: 3.1.0
info:
  title: Glasser
  version: 0.0.1
  description: >-
    Una API Key, sin contrato, con pago por llamada, para APIs de pago
    adquiridas al por mayor. Cada respuesta incluye x-request-id; cada cuerpo de
    error incluye el mismo sobre.
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: Leer un resultado de datos de mercado
      description: >-
        Sigue result_url desde una llamada de datos de mercado para leer los
        resultados normalizados, result_status de negocio y el cargo total de
        los mismos Runs. HTTP 200 aún puede contener result_status=pending. Esta
        lectura autenticada no crea Runs, no llama a ningún proveedor de datos y
        no reanuda el fallback. GET /v1/runs/:id sigue siendo el Run individual
        nativo. El contexto del resultado está firmado, vinculado al Workspace y
        se comprueba con la política de la API Key actual para cada Run.
      operationId: gtm-market-data-result
      parameters:
        - name: token
          in: query
          schema:
            type: string
            minLength: 1
            maxLength: 16384
            description: >-
              Contexto de resultado opaco devuelto en result_url. Consérvalo sin
              cambios y autentícate con una API Key autorizada para leer todos
              los Runs indicados.
          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: Abre este Run en la consola. Requiere pertenecer al Workspace.
        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 o RUNNING: todavía está en curso. COMPLETED: hay una
            respuesta del proveedor de datos disponible, incluidas las
            respuestas que no son 2xx. FAILED: consulta `failure`. STOPPED:
            detenido antes del dispatch. Consulta charge_usd por separado de
            status.
        failure:
          anyOf:
            - type: object
              properties:
                kind:
                  type: string
                  enum:
                    - TIMED_OUT
                    - INTERNAL
                message:
                  type: string
              required:
                - kind
                - message
              additionalProperties: false
            - type: 'null'
          description: >-
            Motivo por el que falló el Run. Solo es distinto de null cuando
            status es 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: >-
            Campos normalizados por action. La salida nativa del proveedor de
            datos no se repite aquí; permanece en el Run (GET /v1/runs/:id). Los
            valores que el proveedor de datos no informa son null; una respuesta
            vacía conserva la estructura de action con todos los campos en null
            (o items: []) y result_status no_result. Los importes están en USD,
            salvo que action incluya un campo de moneda. Las fechas llamadas
            *_date tienen el formato YYYY-MM-DD, *_at tiene el formato ISO 8601
            UTC y *_text es el texto de presentación exactamente como se
            devolvió.


            - property_value: address, property_type, bedrooms, bathrooms,
            living_area_sqft (superficie habitable), lot_size_sqft, year_built,
            latitude, longitude, estimated_value_usd, value_low_usd,
            value_high_usd, comparables_count (número de ventas comparables en
            las que se basa la estimación)

            - property_rent: address, property_type, bedrooms, bathrooms,
            living_area_sqft (superficie habitable), lot_size_sqft, year_built,
            latitude, longitude, estimated_rent_usd (mensual), rent_low_usd,
            rent_high_usd, comparables_count (número de alquileres comparables
            en los que se basa la estimación)

            - property_search: items[]: property_id, address, property_type,
            bedrooms, bathrooms, living_area_sqft (superficie habitable),
            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 (superficie habitable),
            lot_size_sqft, year_built, latitude, longitude, status,
            listing_type, listed_date (YYYY-MM-DD), days_on_market, hoa_fee_usd
            (cuota mensual de HOA), mls_name, mls_number, agent `{name, phone,
            email, website}`, office `{name, phone, email, website}`, price_usd
            (precio solicitado)

            - listings_rental: items[]: listing_id, address, property_type,
            bedrooms, bathrooms, living_area_sqft (superficie habitable),
            lot_size_sqft, year_built, latitude, longitude, status,
            listing_type, listed_date (YYYY-MM-DD), days_on_market, hoa_fee_usd
            (cuota mensual de HOA), 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, cuando RentCast
            actualizó por última vez el agregado), 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 (alquiler mensual), average_days_on_market,
            median_days_on_market, total_listings, new_listings}`

            - stock_quote: symbol, name, exchange, currency, price (último
            precio de la sesión ordinaria, en la moneda correspondiente; las
            cotizaciones de Google Finance pueden tener retraso), change (cambio
            absoluto, en la moneda correspondiente, respecto al cierre ordinario
            anterior), change_percent (puntos porcentuales respecto al cierre
            ordinario anterior: 1.5 = 1.5%), extended_hours_session (etiqueta de
            la sesión tal como se muestra, p. ej., Pre-market o After hours;
            null durante el horario ordinario), extended_hours_price,
            extended_hours_change y extended_hours_change_percent (cotización
            fuera del horario ordinario respecto al precio de la sesión
            ordinaria, en las mismas unidades), as_of_text (marca de tiempo de
            la página de Google Finance exactamente como se muestra, no en
            formato ISO ni correspondiente a la hora del precio)
        provider_response:
          anyOf:
            - type: object
              properties:
                http_status:
                  type: integer
                  minimum: 100
                  maximum: 599
                  description: >-
                    Estado HTTP devuelto por el proveedor de datos. Compruébalo
                    incluso cuando el Run esté COMPLETED.
                error:
                  anyOf:
                    - {}
                    - type: 'null'
              required:
                - http_status
              additionalProperties: false
            - type: 'null'
          description: >-
            Solo es distinto de null cuando status es COMPLETED.


            - Para respuestas 2xx, output contiene JSON nativo del proveedor de
            datos (con cualquier estructura) o null si el cuerpo está vacío.

            - Para respuestas que no son 2xx, error contiene el cuerpo del error
            del proveedor de datos y output es null.


            Los campos sensibles se eliminan de ambos cuerpos.
        charge_usd:
          anyOf:
            - type: string
              pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
              description: >-
                Cadena decimal exacta en USD (mínimo 2 y máximo 6 decimales, con
                una única representación canónica). Suma con aritmética decimal
                o escala por 10^6; nunca uses números de coma flotante.
            - type: 'null'
          description: >-
            Cargo total de los Runs de esta respuesta de Solution. Es null hasta
            que se liquiden todos los Runs incluidos. Cada Run conserva su
            propio cargo; los fallos también pueden generar cargos.
        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: >-
            Base del cargo de un único Run, o null para un total de varios Runs.
            Consulta runs[].charge_basis para cada cargo.
        stoppable:
          type: boolean
          description: >-
            Indica si actualmente se puede aceptar una solicitud de detención.
            Esto no garantiza que el Run pueda detenerse antes del dispatch.
        stop_requested_at:
          anyOf:
            - type: string
              description: Marca de tiempo UTC ISO-8601
              format: date-time
            - type: 'null'
          description: >-
            Momento en que se solicitó la detención. El Run puede continuar si
            el dispatch ya había comenzado.
        created_at:
          type: string
          description: Marca de tiempo UTC ISO-8601
          format: date-time
        started_at:
          anyOf:
            - type: string
              description: Marca de tiempo UTC ISO-8601
              format: date-time
            - type: 'null'
        completed_at:
          anyOf:
            - type: string
              description: Marca de tiempo UTC ISO-8601
              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: >-
            Tus campos de seguimiento almacenados. Úsalos para filtrar Runs.
            Nunca se envían al proveedor de datos ni afectan al enrutamiento,
            Price o la idempotencia.


            - Hasta 20 claves: letras minúsculas, dígitos y guiones bajos; deben
            comenzar por una letra; como máximo 40 caracteres.

            - Valores: cadenas de 1–500 caracteres.

            - user_id: el ID opaco de tu usuario final, nunca su dirección de
            correo electrónico ni su nombre.
        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: >-
            Estado de entrega empresarial, independiente del ciclo de vida final
            del Run en status. no_result es una respuesta vacía pero válida;
            error significa que no se pudo entregar la salida del proveedor de
            datos.
        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: Abre este Run en la consola. Requiere pertenecer al Workspace.
              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 o RUNNING: todavía está en curso. COMPLETED: hay una
                  respuesta del proveedor de datos disponible, incluidas las
                  respuestas que no son 2xx. FAILED: consulta `failure`.
                  STOPPED: detenido antes del dispatch. Consulta charge_usd por
                  separado de status.
              failure:
                anyOf:
                  - type: object
                    properties:
                      kind:
                        type: string
                        enum:
                          - TIMED_OUT
                          - INTERNAL
                      message:
                        type: string
                    required:
                      - kind
                      - message
                    additionalProperties: false
                  - type: 'null'
                description: >-
                  Motivo por el que falló el Run. Solo es distinto de null
                  cuando status es 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: >-
                          Estado HTTP devuelto por el proveedor de datos.
                          Compruébalo incluso cuando el Run esté 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: >-
                      Cadena decimal exacta en USD (mínimo 2 y máximo 6
                      decimales, con una única representación canónica). Suma
                      con aritmética decimal o escala por 10^6; nunca uses
                      números de coma flotante.
                  - type: 'null'
                description: >-
                  Cargo final como cadena decimal exacta en USD. Es null
                  mientras está QUEUED o RUNNING. Un Run FAILED puede tener un
                  cargo distinto de cero según el Price del Endpoint.
              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: >-
                  Cláusula de Price utilizada para calcular el cargo. Es null
                  antes de la liquidación o cuando no se realizó ningún intento
                  con el proveedor de datos.
              stoppable:
                type: boolean
                description: >-
                  Indica si actualmente se puede aceptar una solicitud de
                  detención. Esto no garantiza que el Run pueda detenerse antes
                  del dispatch.
              stop_requested_at:
                anyOf:
                  - type: string
                    description: Marca de tiempo UTC ISO-8601
                    format: date-time
                  - type: 'null'
                description: >-
                  Momento en que se solicitó la detención. El Run puede
                  continuar si el dispatch ya había comenzado.
              created_at:
                type: string
                description: Marca de tiempo UTC ISO-8601
                format: date-time
              started_at:
                anyOf:
                  - type: string
                    description: Marca de tiempo UTC ISO-8601
                    format: date-time
                  - type: 'null'
              completed_at:
                anyOf:
                  - type: string
                    description: Marca de tiempo UTC ISO-8601
                    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: >-
                  Tus campos de seguimiento almacenados. Úsalos para filtrar
                  Runs. Nunca se envían al proveedor de datos ni afectan al
                  enrutamiento, Price o la idempotencia.


                  - Hasta 20 claves: letras minúsculas, dígitos y guiones bajos;
                  deben comenzar por una letra; como máximo 40 caracteres.

                  - Valores: cadenas de 1–500 caracteres.

                  - user_id: el ID opaco de tu usuario final, nunca su dirección
                  de correo electrónico ni su nombre.
            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: >-
            Ruta de URL autenticada y de solo lectura para consultar este
            resultado normalizado y el cargo total. Úsala con el origen de la
            API. No crea Runs ni reanuda el fallback. GET /v1/runs/:id sigue
            devolviendo el Run nativo e individual.
      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.