> ## Documentation Index > Fetch the complete documentation index at: https://docs.quoindata.com/llms.txt > Use this file to discover all available pages before exploring further. # query_properties > Free catalog/approved vocabulary. $0.05 for rows/summary. report_comparables_v1 includes characteristics for up to 50 sales. ## OpenAPI ````yaml https://portal.quoindata.com/api/v3/openapi.json post /api/v3/record-queries openapi: 3.1.0 info: title: Quoin Property API v3 version: quoin-v3 description: Free bounded discovery; paid connected records. Rate portal-v3-2026-09. servers: - url: https://portal.quoindata.com security: [] paths: /api/v3/record-queries: post: summary: query_properties description: >- Free catalog/approved vocabulary. $0.05 for rows/summary. report_comparables_v1 includes characteristics for up to 50 sales. operationId: query_properties parameters: - name: Idempotency-Key in: header required: false schema: type: string minLength: 1 maxLength: 256 description: >- Use a unique key per logical call; identical retries within seven days add no charge. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/query_properties' responses: '200': description: Completed call headers: X-Quoin-Price-Micro-USD: schema: type: integer description: 'Original call price: 0 or 50000 micro-USD.' X-Quoin-Charged-Micro-USD: schema: type: integer description: >- New gross usage on this response before welcome credit; 0 on replay. X-Quoin-Balance-Micro-USD: schema: type: integer description: X-Quoin-Balance-Micro-USD X-Quoin-Calls-30d: schema: type: integer description: X-Quoin-Calls-30d X-RateLimit-Limit: schema: type: integer description: X-RateLimit-Limit X-RateLimit-Remaining: schema: type: integer description: X-RateLimit-Remaining X-RateLimit-Reset: schema: type: integer description: X-RateLimit-Reset content: application/json: schema: $ref: '#/components/schemas/Envelope' '400': description: Uncharged error (400) headers: X-Quoin-Price-Micro-USD: schema: type: integer description: 'Original call price: 0 or 50000 micro-USD.' X-Quoin-Charged-Micro-USD: schema: type: integer description: >- New gross usage on this response before welcome credit; 0 on replay. X-Quoin-Balance-Micro-USD: schema: type: integer description: X-Quoin-Balance-Micro-USD X-Quoin-Calls-30d: schema: type: integer description: X-Quoin-Calls-30d X-RateLimit-Limit: schema: type: integer description: X-RateLimit-Limit X-RateLimit-Remaining: schema: type: integer description: X-RateLimit-Remaining X-RateLimit-Reset: schema: type: integer description: X-RateLimit-Reset content: application/json: schema: $ref: '#/components/schemas/Envelope' '401': description: Uncharged error (401) headers: X-Quoin-Price-Micro-USD: schema: type: integer description: 'Original call price: 0 or 50000 micro-USD.' X-Quoin-Charged-Micro-USD: schema: type: integer description: >- New gross usage on this response before welcome credit; 0 on replay. X-Quoin-Balance-Micro-USD: schema: type: integer description: X-Quoin-Balance-Micro-USD X-Quoin-Calls-30d: schema: type: integer description: X-Quoin-Calls-30d X-RateLimit-Limit: schema: type: integer description: X-RateLimit-Limit X-RateLimit-Remaining: schema: type: integer description: X-RateLimit-Remaining X-RateLimit-Reset: schema: type: integer description: X-RateLimit-Reset content: application/json: schema: $ref: '#/components/schemas/Envelope' '402': description: Uncharged error (402) headers: X-Quoin-Price-Micro-USD: schema: type: integer description: 'Original call price: 0 or 50000 micro-USD.' X-Quoin-Charged-Micro-USD: schema: type: integer description: >- New gross usage on this response before welcome credit; 0 on replay. X-Quoin-Balance-Micro-USD: schema: type: integer description: X-Quoin-Balance-Micro-USD X-Quoin-Calls-30d: schema: type: integer description: X-Quoin-Calls-30d X-RateLimit-Limit: schema: type: integer description: X-RateLimit-Limit X-RateLimit-Remaining: schema: type: integer description: X-RateLimit-Remaining X-RateLimit-Reset: schema: type: integer description: X-RateLimit-Reset content: application/json: schema: $ref: '#/components/schemas/Envelope' '403': description: Uncharged error (403) headers: X-Quoin-Price-Micro-USD: schema: type: integer description: 'Original call price: 0 or 50000 micro-USD.' X-Quoin-Charged-Micro-USD: schema: type: integer description: >- New gross usage on this response before welcome credit; 0 on replay. X-Quoin-Balance-Micro-USD: schema: type: integer description: X-Quoin-Balance-Micro-USD X-Quoin-Calls-30d: schema: type: integer description: X-Quoin-Calls-30d X-RateLimit-Limit: schema: type: integer description: X-RateLimit-Limit X-RateLimit-Remaining: schema: type: integer description: X-RateLimit-Remaining X-RateLimit-Reset: schema: type: integer description: X-RateLimit-Reset content: application/json: schema: $ref: '#/components/schemas/Envelope' '404': description: Uncharged error (404) headers: X-Quoin-Price-Micro-USD: schema: type: integer description: 'Original call price: 0 or 50000 micro-USD.' X-Quoin-Charged-Micro-USD: schema: type: integer description: >- New gross usage on this response before welcome credit; 0 on replay. X-Quoin-Balance-Micro-USD: schema: type: integer description: X-Quoin-Balance-Micro-USD X-Quoin-Calls-30d: schema: type: integer description: X-Quoin-Calls-30d X-RateLimit-Limit: schema: type: integer description: X-RateLimit-Limit X-RateLimit-Remaining: schema: type: integer description: X-RateLimit-Remaining X-RateLimit-Reset: schema: type: integer description: X-RateLimit-Reset content: application/json: schema: $ref: '#/components/schemas/Envelope' '409': description: Uncharged error (409) headers: X-Quoin-Price-Micro-USD: schema: type: integer description: 'Original call price: 0 or 50000 micro-USD.' X-Quoin-Charged-Micro-USD: schema: type: integer description: >- New gross usage on this response before welcome credit; 0 on replay. X-Quoin-Balance-Micro-USD: schema: type: integer description: X-Quoin-Balance-Micro-USD X-Quoin-Calls-30d: schema: type: integer description: X-Quoin-Calls-30d X-RateLimit-Limit: schema: type: integer description: X-RateLimit-Limit X-RateLimit-Remaining: schema: type: integer description: X-RateLimit-Remaining X-RateLimit-Reset: schema: type: integer description: X-RateLimit-Reset content: application/json: schema: $ref: '#/components/schemas/Envelope' '413': description: Uncharged error (413) headers: X-Quoin-Price-Micro-USD: schema: type: integer description: 'Original call price: 0 or 50000 micro-USD.' X-Quoin-Charged-Micro-USD: schema: type: integer description: >- New gross usage on this response before welcome credit; 0 on replay. X-Quoin-Balance-Micro-USD: schema: type: integer description: X-Quoin-Balance-Micro-USD X-Quoin-Calls-30d: schema: type: integer description: X-Quoin-Calls-30d X-RateLimit-Limit: schema: type: integer description: X-RateLimit-Limit X-RateLimit-Remaining: schema: type: integer description: X-RateLimit-Remaining X-RateLimit-Reset: schema: type: integer description: X-RateLimit-Reset content: application/json: schema: $ref: '#/components/schemas/Envelope' '422': description: Uncharged error (422) headers: X-Quoin-Price-Micro-USD: schema: type: integer description: 'Original call price: 0 or 50000 micro-USD.' X-Quoin-Charged-Micro-USD: schema: type: integer description: >- New gross usage on this response before welcome credit; 0 on replay. X-Quoin-Balance-Micro-USD: schema: type: integer description: X-Quoin-Balance-Micro-USD X-Quoin-Calls-30d: schema: type: integer description: X-Quoin-Calls-30d X-RateLimit-Limit: schema: type: integer description: X-RateLimit-Limit X-RateLimit-Remaining: schema: type: integer description: X-RateLimit-Remaining X-RateLimit-Reset: schema: type: integer description: X-RateLimit-Reset content: application/json: schema: $ref: '#/components/schemas/Envelope' '429': description: Uncharged error (429) headers: X-Quoin-Price-Micro-USD: schema: type: integer description: 'Original call price: 0 or 50000 micro-USD.' X-Quoin-Charged-Micro-USD: schema: type: integer description: >- New gross usage on this response before welcome credit; 0 on replay. X-Quoin-Balance-Micro-USD: schema: type: integer description: X-Quoin-Balance-Micro-USD X-Quoin-Calls-30d: schema: type: integer description: X-Quoin-Calls-30d X-RateLimit-Limit: schema: type: integer description: X-RateLimit-Limit X-RateLimit-Remaining: schema: type: integer description: X-RateLimit-Remaining X-RateLimit-Reset: schema: type: integer description: X-RateLimit-Reset content: application/json: schema: $ref: '#/components/schemas/Envelope' '503': description: Uncharged error (503) headers: X-Quoin-Price-Micro-USD: schema: type: integer description: 'Original call price: 0 or 50000 micro-USD.' X-Quoin-Charged-Micro-USD: schema: type: integer description: >- New gross usage on this response before welcome credit; 0 on replay. X-Quoin-Balance-Micro-USD: schema: type: integer description: X-Quoin-Balance-Micro-USD X-Quoin-Calls-30d: schema: type: integer description: X-Quoin-Calls-30d X-RateLimit-Limit: schema: type: integer description: X-RateLimit-Limit X-RateLimit-Remaining: schema: type: integer description: X-RateLimit-Remaining X-RateLimit-Reset: schema: type: integer description: X-RateLimit-Reset content: application/json: schema: $ref: '#/components/schemas/Envelope' security: - bearer_auth: [] components: schemas: query_properties: type: object properties: mode: default: catalog type: string enum: - catalog - values - rows - summary dataset: default: properties type: string enum: - properties - sales - tax_periods - buildings filters: type: object properties: property: maxItems: 20 type: array items: type: object properties: field: type: string minLength: 1 maxLength: 256 op: type: string enum: - eq - ne - in - gte - lte - between - contains - is_null - not_null value: anyOf: - anyOf: - type: string maxLength: 256 - type: number - minItems: 1 maxItems: 20 type: array items: anyOf: - type: string maxLength: 256 - type: number required: - field - op additionalProperties: false sale: maxItems: 20 type: array items: type: object properties: field: type: string minLength: 1 maxLength: 256 op: type: string enum: - eq - ne - in - gte - lte - between - contains - is_null - not_null value: anyOf: - anyOf: - type: string maxLength: 256 - type: number - minItems: 1 maxItems: 20 type: array items: anyOf: - type: string maxLength: 256 - type: number required: - field - op additionalProperties: false tax: maxItems: 20 type: array items: type: object properties: field: type: string minLength: 1 maxLength: 256 op: type: string enum: - eq - ne - in - gte - lte - between - contains - is_null - not_null value: anyOf: - anyOf: - type: string maxLength: 256 - type: number - minItems: 1 maxItems: 20 type: array items: anyOf: - type: string maxLength: 256 - type: number required: - field - op additionalProperties: false building: maxItems: 20 type: array items: type: object properties: field: type: string minLength: 1 maxLength: 256 op: type: string enum: - eq - ne - in - gte - lte - between - contains - is_null - not_null value: anyOf: - anyOf: - type: string maxLength: 256 - type: number - minItems: 1 maxItems: 20 type: array items: anyOf: - type: string maxLength: 256 - type: number required: - field - op additionalProperties: false additionalProperties: false field: type: string minLength: 1 maxLength: 256 group_by: type: string minLength: 1 maxLength: 256 measure: type: string minLength: 1 maxLength: 256 location: type: object properties: latitude: type: number minimum: -90 maximum: 90 longitude: type: number minimum: -180 maximum: 180 radius_miles: type: number exclusiveMinimum: 0 required: - latitude - longitude - radius_miles additionalProperties: false limit: default: 20 type: integer minimum: 1 maximum: 50 cursor: type: string minLength: 1 maxLength: 4096 projection: type: string const: report_comparables_v1 subject_property_ref: type: string minLength: 1 maxLength: 512 radius_miles: type: number exclusiveMinimum: 0 maximum: 100 additionalProperties: false Envelope: type: object required: - contract_version - request_id - operation - status - data - error - meta properties: contract_version: const: quoin-v3 request_id: type: string operation: type: string status: enum: - ok - partial - error data: anyOf: - $ref: '#/components/schemas/ReportSubject' - $ref: '#/components/schemas/ReportComparables' - type: - object - 'null' error: type: - object - 'null' properties: code: type: string message: type: string retryable: type: boolean meta: type: object properties: served_at: type: string format: date-time truncated: type: boolean next_cursor: type: - string - 'null' ReportSubject: type: object properties: projection: type: string const: report_subject_v1 snapshot: type: string sources: type: array items: type: object properties: source_id: type: string release_id: type: number sha256: type: string official_url: type: - string - 'null' required: - source_id - release_id - sha256 - official_url additionalProperties: {} items: minItems: 1 maxItems: 1 type: array items: type: object properties: property_ref: type: string outcome: type: string const: ok location: anyOf: - type: object properties: latitude: type: number longitude: type: number required: - latitude - longitude additionalProperties: {} - type: 'null' characteristics: type: object properties: status: type: string enum: - reported - ambiguous - unavailable profile_count: type: integer minimum: 0 maximum: 9007199254740991 building_type: type: - string - 'null' use_description: type: - string - 'null' bedrooms: type: - number - 'null' full_bathrooms: type: - number - 'null' half_bathrooms: type: - number - 'null' gross_area_sqft: type: - number - 'null' living_area_sqft: type: - number - 'null' year_built: type: - number - 'null' effective_year_built: type: - string - number - 'null' condition: type: - string - 'null' grade: type: - string - 'null' source_release_id: type: - number - 'null' data_date_min: type: - string - 'null' data_date_max: type: - string - 'null' limitations: type: string source_refs: type: array items: type: string minLength: 1 maxLength: 512 required: - status - profile_count - building_type - use_description - bedrooms - full_bathrooms - half_bathrooms - gross_area_sqft - living_area_sqft - year_built - effective_year_built - condition - grade - source_release_id - data_date_min - data_date_max - limitations - source_refs additionalProperties: false sections: type: object properties: identity: type: object properties: property_ref: type: string address: type: - string - 'null' ssl: type: - string - 'null' area_uid: type: string const: area_us_dc status: type: string const: active property_type: type: - string - 'null' use_code: type: - string - 'null' required: - property_ref - address - ssl - area_uid - status - property_type - use_code additionalProperties: false ownership: type: object properties: owner_name: type: object properties: value: type: - string - number - boolean - 'null' status: type: string source_refs: type: array items: type: string minLength: 1 maxLength: 512 required: - value - status - source_refs additionalProperties: {} owner_name_2: type: object properties: value: type: - string - number - boolean - 'null' status: type: string source_refs: type: array items: type: string minLength: 1 maxLength: 512 required: - value - status - source_refs additionalProperties: {} ownership_form: type: object properties: value: type: - string - number - boolean - 'null' status: type: string source_refs: type: array items: type: string minLength: 1 maxLength: 512 required: - value - status - source_refs additionalProperties: {} required: - owner_name - owner_name_2 - ownership_form additionalProperties: false assessment: type: object properties: basis: type: string assessment_year: type: 'null' assessment_year_status: type: string const: unavailable data_date: type: - string - 'null' land_value_dollars: type: object properties: value: type: - string - number - boolean - 'null' status: type: string source_refs: type: array items: type: string minLength: 1 maxLength: 512 required: - value - status - source_refs additionalProperties: {} improvement_value_dollars: type: object properties: value: type: - string - number - boolean - 'null' status: type: string source_refs: type: array items: type: string minLength: 1 maxLength: 512 required: - value - status - source_refs additionalProperties: {} total_value_dollars: type: object properties: value: type: - string - number - boolean - 'null' status: type: string source_refs: type: array items: type: string minLength: 1 maxLength: 512 required: - value - status - source_refs additionalProperties: {} required: - basis - assessment_year - assessment_year_status - data_date - land_value_dollars - improvement_value_dollars - total_value_dollars additionalProperties: false tax: type: object properties: data_date: type: - string - 'null' tax_period: type: 'null' tax_period_status: type: string const: unavailable annual_tax_dollars: type: object properties: value: type: - string - number - boolean - 'null' status: type: string source_refs: type: array items: type: string minLength: 1 maxLength: 512 required: - value - status - source_refs additionalProperties: {} reported_balance_dollars: type: object properties: value: type: - string - number - boolean - 'null' status: type: string source_refs: type: array items: type: string minLength: 1 maxLength: 512 required: - value - status - source_refs additionalProperties: {} limitations: type: array items: type: string required: - data_date - tax_period - tax_period_status - annual_tax_dollars - reported_balance_dollars - limitations additionalProperties: false transfer: type: object properties: sale_date: type: - string - 'null' price_dollars: type: - number - 'null' sale_type: type: - string - 'null' acceptance_code: type: - string - 'null' data_date: type: - string - 'null' source_refs: type: array items: type: string minLength: 1 maxLength: 512 required: - sale_date - price_dollars - sale_type - acceptance_code - data_date - source_refs additionalProperties: false building: type: object properties: status: type: string enum: - reported - ambiguous - unavailable profile_count: type: integer minimum: 0 maximum: 9007199254740991 building_type: type: - string - 'null' use_description: type: - string - 'null' bedrooms: type: - number - 'null' full_bathrooms: type: - number - 'null' half_bathrooms: type: - number - 'null' gross_area_sqft: type: - number - 'null' living_area_sqft: type: - number - 'null' year_built: type: - number - 'null' effective_year_built: type: - string - number - 'null' condition: type: - string - 'null' grade: type: - string - 'null' source_release_id: type: - number - 'null' data_date_min: type: - string - 'null' data_date_max: type: - string - 'null' limitations: type: string source_refs: type: array items: type: string minLength: 1 maxLength: 512 required: - status - profile_count - building_type - use_description - bedrooms - full_bathrooms - half_bathrooms - gross_area_sqft - living_area_sqft - year_built - effective_year_built - condition - grade - source_release_id - data_date_min - data_date_max - limitations - source_refs additionalProperties: false land: type: object properties: land_area_square_feet: type: object properties: value: type: - string - number - boolean - 'null' status: type: string source_refs: type: array items: type: string minLength: 1 maxLength: 512 required: - value - status - source_refs additionalProperties: {} required: - land_area_square_feet additionalProperties: false permit: type: object properties: availability: type: string const: available total_count: type: integer minimum: 0 maximum: 9007199254740991 has_more: type: boolean records: maxItems: 5 type: array items: type: object properties: record_number: type: - string - 'null' record_type: type: string status: type: - string - 'null' record_date: type: - string - 'null' source_refs: type: array items: type: string minLength: 1 maxLength: 512 required: - record_number - record_type - status - record_date - source_refs additionalProperties: {} limitations: type: array items: type: string required: - availability - total_count - has_more - records - limitations additionalProperties: {} required: - identity - ownership - assessment - tax - transfer - building - land - permit additionalProperties: false required: - property_ref - outcome - location - characteristics - sections additionalProperties: false required: - projection - snapshot - sources - items additionalProperties: false ReportComparables: type: object properties: projection: type: string const: report_comparables_v1 dataset: type: string const: sales mode: type: string const: rows rows: maxItems: 50 type: array items: type: object properties: property_ref: type: string record_ref: type: string address: type: - string - 'null' unit: type: - string - 'null' location: anyOf: - type: object properties: latitude: type: number longitude: type: number required: - latitude - longitude additionalProperties: {} - type: 'null' property: type: object properties: property_type: type: - string - 'null' use_code: type: - string - 'null' land_area_sqft: type: - number - 'null' neighborhood: type: - string - 'null' data_date: type: - string - 'null' source_refs: type: array items: type: string minLength: 1 maxLength: 512 required: - property_type - use_code - land_area_sqft - neighborhood - data_date - source_refs additionalProperties: false sale: type: object properties: sale_code: type: - string - 'null' sale_date: type: - string - 'null' price_dollars: type: - number - 'null' qualified_code: type: - string - 'null' current_owner_flag: type: - number - 'null' required: - sale_code - sale_date - price_dollars - qualified_code - current_owner_flag additionalProperties: false source_refs: type: array items: type: string minLength: 1 maxLength: 512 characteristics: type: object properties: status: type: string enum: - reported - ambiguous - unavailable profile_count: type: integer minimum: 0 maximum: 9007199254740991 building_type: type: - string - 'null' use_description: type: - string - 'null' bedrooms: type: - number - 'null' full_bathrooms: type: - number - 'null' half_bathrooms: type: - number - 'null' gross_area_sqft: type: - number - 'null' living_area_sqft: type: - number - 'null' year_built: type: - number - 'null' effective_year_built: type: - string - number - 'null' condition: type: - string - 'null' grade: type: - string - 'null' source_release_id: type: - number - 'null' data_date_min: type: - string - 'null' data_date_max: type: - string - 'null' limitations: type: string source_refs: type: array items: type: string minLength: 1 maxLength: 512 required: - status - profile_count - building_type - use_description - bedrooms - full_bathrooms - half_bathrooms - gross_area_sqft - living_area_sqft - year_built - effective_year_built - condition - grade - source_release_id - data_date_min - data_date_max - limitations - source_refs additionalProperties: false distance_miles: type: - number - 'null' required: - property_ref - record_ref - address - unit - location - property - sale - source_refs - characteristics - distance_miles additionalProperties: false returned_count: type: integer minimum: 0 maximum: 50 has_more: type: boolean next_cursor: type: - string - 'null' snapshot: type: string sources: type: array items: type: object properties: source_id: type: string release_id: type: number sha256: type: string official_url: type: - string - 'null' required: - source_id - release_id - sha256 - official_url additionalProperties: {} ordering: type: string spatial_limitations: type: string next_page_price_cents: type: number const: 5 caveats: type: array items: type: string required: - projection - dataset - mode - rows - returned_count - has_more - next_cursor - snapshot - sources - ordering - spatial_limitations - next_page_price_cents - caveats additionalProperties: false securitySchemes: bearer_auth: type: http scheme: bearer bearerFormat: qk_... ````