Smarty

Smarty us-enrichment API

The us-enrichment API from Smarty — 8 operation(s) for us-enrichment.

GitHub OpenAPI

Operations 8

GET /lookup/{smartykey}/property Property Lookup by Smartykey #
GET /lookup/search/property Property Lookup by Search Fields #
GET /lookup/{smarykey}/geo-reference/{dataset?} US Census Block and Tract Lookup by Smartykey #
GET /lookup/search/geo-reference/{dataset?} US Census Block and Tract Data Lookup by Search Fields #
GET /lookup/{smartykey}/secondary US Secondary Data Lookup by Smartykey #
GET /lookup/search/secondary US Secondary Data Lookup by Search Fields #
GET /lookup/{smartykey}/secondary/count US Secondary Data Lookup by Smartykey #
GET /lookup/search/secondary/count US Secondary Data Lookup by Search Fields #

Documentation

📖
Documentation
https://www.smarty.com/docs/apis/us-street-api/reference
📖
Documentation
https://www.smarty.com/docs/cloud/us-autocomplete-pro-api
📖
Documentation
https://www.smarty.com/docs/cloud/us-zipcode-api
📖
Documentation
https://www.smarty.com/docs/cloud/us-reverse-geo-api
📖
Documentation
https://www.smarty.com/docs/cloud/us-enrichment-api
📖
Documentation
https://www.smarty.com/docs/cloud/us-extract-api
📖
Documentation
https://www.smarty.com/docs/cloud/international-street-api
📖
Documentation
https://www.smarty.com/docs/cloud/international-autocomplete-api
📖
Documentation
https://www.smarty.com/docs/cloud/international-postal-code-api

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/smarty/refs/heads/main/openapi/smarty-us-enrichment-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/smarty-us-enrichment-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

smarty-us-enrichment-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: api Us Enrichment API
  version: '1.0'
  description: This page describes how to retrieve data from various different datasets using the Smarty US Address Enrichment API.
  contact:
    url: https://www.smarty.com/contact/support
    email: support@smarty.com
    name: Smarty Support
  termsOfService: https://www.smarty.com/legal/terms-of-service
  license:
    url: https://www.smarty.com/legal/terms-of-service
    name: Smarty License
servers:
- url: https://us-enrichment.api.smarty.com
tags:
- name: us-enrichment
paths:
  /lookup/{smartykey}/property:
    get:
      operationId: get-lookup-smartykey-property
      tags:
      - us-enrichment
      summary: Property Lookup by Smartykey
      description: Contains all property data attributes including tax assessor and recorder data. Recorder data will be last available financial transaction for the property. When requesting the financial feature, the result will contain historical financial data pertaining to the property and property owner.
      security:
      - auth-id: []
        auth-token: []
      - embedded-key: []
      parameters:
      - $ref: '#/components/parameters/smartykey'
      - $ref: '#/components/parameters/content-type'
      - $ref: '#/components/parameters/etag'
      - $ref: '#/components/parameters/include'
      - $ref: '#/components/parameters/exclude'
      - $ref: '#/components/parameters/features'
      responses:
        '200':
          $ref: '#/components/responses/PropertyResponseSmartyKey'
        '304':
          $ref: '#/components/responses/NotModified'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '413':
          $ref: '#/components/responses/RequestTooLarge'
        '422':
          $ref: '#/components/responses/UnprocessableContent'
        '429':
          $ref: '#/components/responses/TooManyRequests'
  /lookup/search/property:
    get:
      operationId: get-lookup-property
      tags:
      - us-enrichment
      summary: Property Lookup by Search Fields
      description: Contains all property data attributes including tax assessor and recorder data. Recorder data will be last available financial transaction for the property. When requesting the financial feature, the result will contain historical financial data pertaining to the property and property owner.
      security:
      - auth-id: []
        auth-token: []
      - embedded-key: []
      parameters:
      - $ref: '#/components/parameters/content-type'
      - $ref: '#/components/parameters/etag'
      - $ref: '#/components/parameters/include'
      - $ref: '#/components/parameters/exclude'
      - $ref: '#/components/parameters/features'
      - $ref: '#/components/parameters/freeform'
      - $ref: '#/components/parameters/street'
      - $ref: '#/components/parameters/city'
      - $ref: '#/components/parameters/state'
      - $ref: '#/components/parameters/zipcode'
      responses:
        '200':
          $ref: '#/components/responses/PropertyResponseSearch'
        '304':
          $ref: '#/components/responses/NotModified'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '413':
          $ref: '#/components/responses/RequestTooLarge'
        '422':
          $ref: '#/components/responses/UnprocessableContent'
        '429':
          $ref: '#/components/responses/TooManyRequests'
  /lookup/{smarykey}/geo-reference/{dataset?}:
    get:
      operationId: get-lookup-smartykey-geo
      tags:
      - us-enrichment
      summary: US Census Block and Tract Lookup by Smartykey
      description: 'The Census Block and Tract Data product provides useful geographic data for geocoded addresses, such as census block id. Request legacy data, such as the 2010 and 2020 census, by specifying a data subset of 2010 or 2020. For example: To return 2010 census data, specify geo-reference/2010. To request the latest census information available, simply specify geo-reference with no trailing subset. The census version will be returned in the data_set_version property in the response.'
      security:
      - auth-id: []
        auth-token: []
      - embedded-key: []
      parameters:
      - $ref: '#/components/parameters/smartykey'
      - $ref: '#/components/parameters/dataset'
      - $ref: '#/components/parameters/content-type'
      - $ref: '#/components/parameters/etag'
      - $ref: '#/components/parameters/include'
      - $ref: '#/components/parameters/exclude'
      - $ref: '#/components/parameters/features'
      responses:
        '200':
          $ref: '#/components/responses/CensusBlockAndTractResponseSmartyKey'
        '304':
          $ref: '#/components/responses/NotModified'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '413':
          $ref: '#/components/responses/RequestTooLarge'
        '422':
          $ref: '#/components/responses/UnprocessableContent'
        '429':
          $ref: '#/components/responses/TooManyRequests'
  /lookup/search/geo-reference/{dataset?}:
    get:
      operationId: get-lookup-geo
      tags:
      - us-enrichment
      summary: US Census Block and Tract Data Lookup by Search Fields
      description: 'The Census Block and Tract Data product provides useful geographic data for geocoded addresses, such as census block id. Request legacy data, such as the 2010 and 2020 census, by specifying a data subset of 2010 or 2020. For example: To return 2010 census data, specify geo-reference/2010. To request the latest census information available, simply specify geo-reference with no trailing subset. The census version will be returned in the data_set_version property in the response.'
      security:
      - auth-id: []
        auth-token: []
      - embedded-key: []
      parameters:
      - $ref: '#/components/parameters/dataset'
      - $ref: '#/components/parameters/content-type'
      - $ref: '#/components/parameters/etag'
      - $ref: '#/components/parameters/include'
      - $ref: '#/components/parameters/exclude'
      - $ref: '#/components/parameters/features'
      - $ref: '#/components/parameters/freeform'
      - $ref: '#/components/parameters/street'
      - $ref: '#/components/parameters/city'
      - $ref: '#/components/parameters/state'
      - $ref: '#/components/parameters/zipcode'
      responses:
        '200':
          $ref: '#/components/responses/CensusBlockAndTractResponseSearch'
        '304':
          $ref: '#/components/responses/NotModified'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '413':
          $ref: '#/components/responses/RequestTooLarge'
        '422':
          $ref: '#/components/responses/UnprocessableContent'
        '429':
          $ref: '#/components/responses/TooManyRequests'
  /lookup/{smartykey}/secondary:
    get:
      operationId: get-lookup-smartykey-secondary
      tags:
      - us-enrichment
      summary: US Secondary Data Lookup by Smartykey
      description: The secondary data product returns all secondaries and aliases associated with a SmartyKey. The SmartyKey can be that of the root address, any of the aliases, or any of the secondaries. Each will return the same related data.
      security:
      - auth-id: []
        auth-token: []
      - embedded-key: []
      parameters:
      - $ref: '#/components/parameters/smartykey'
      - $ref: '#/components/parameters/content-type'
      - $ref: '#/components/parameters/etag'
      - $ref: '#/components/parameters/include'
      - $ref: '#/components/parameters/exclude'
      - $ref: '#/components/parameters/features'
      responses:
        '200':
          $ref: '#/components/responses/SecondaryResponseSmartyKey'
        '304':
          $ref: '#/components/responses/NotModified'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '413':
          $ref: '#/components/responses/RequestTooLarge'
        '422':
          $ref: '#/components/responses/UnprocessableContent'
        '429':
          $ref: '#/components/responses/TooManyRequests'
  /lookup/search/secondary:
    get:
      operationId: get-lookup-secondary
      tags:
      - us-enrichment
      summary: US Secondary Data Lookup by Search Fields
      description: The secondary data product returns all secondaries and aliases associated with a SmartyKey. Each will return the same related data.
      security:
      - auth-id: []
        auth-token: []
      - embedded-key: []
      parameters:
      - $ref: '#/components/parameters/content-type'
      - $ref: '#/components/parameters/etag'
      - $ref: '#/components/parameters/include'
      - $ref: '#/components/parameters/exclude'
      - $ref: '#/components/parameters/features'
      - $ref: '#/components/parameters/freeform'
      - $ref: '#/components/parameters/street'
      - $ref: '#/components/parameters/city'
      - $ref: '#/components/parameters/state'
      - $ref: '#/components/parameters/zipcode'
      responses:
        '200':
          $ref: '#/components/responses/SecondaryResponseSearch'
        '304':
          $ref: '#/components/responses/NotModified'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '413':
          $ref: '#/components/responses/RequestTooLarge'
        '422':
          $ref: '#/components/responses/UnprocessableContent'
        '429':
          $ref: '#/components/responses/TooManyRequests'
  /lookup/{smartykey}/secondary/count:
    get:
      operationId: get-lookup-smartykey-secondary-count
      tags:
      - us-enrichment
      summary: US Secondary Data Lookup by Smartykey
      description: The secondary data product returns all secondaries and aliases associated with a SmartyKey. The SmartyKey can be that of the root address, any of the aliases, or any of the secondaries. Each will return the same related data. The count subset only returns the number of secondaries associated with the SmartyKey. Detailed data is not returned.
      security:
      - auth-id: []
        auth-token: []
      - embedded-key: []
      parameters:
      - $ref: '#/components/parameters/smartykey'
      - $ref: '#/components/parameters/content-type'
      - $ref: '#/components/parameters/etag'
      - $ref: '#/components/parameters/include'
      - $ref: '#/components/parameters/exclude'
      - $ref: '#/components/parameters/features'
      responses:
        '200':
          $ref: '#/components/responses/SecondaryCountResponseSmartyKey'
        '304':
          $ref: '#/components/responses/NotModified'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '413':
          $ref: '#/components/responses/RequestTooLarge'
        '422':
          $ref: '#/components/responses/UnprocessableContent'
        '429':
          $ref: '#/components/responses/TooManyRequests'
  /lookup/search/secondary/count:
    get:
      operationId: get-lookup-secondary-count
      tags:
      - us-enrichment
      summary: US Secondary Data Lookup by Search Fields
      description: The secondary data product returns all secondaries and aliases associated with a SmartyKey. Each will return the same related data. The count subset only returns the number of secondaries associated with the SmartyKey. Detailed data is not returned.
      security:
      - auth-id: []
        auth-token: []
      - embedded-key: []
      parameters:
      - $ref: '#/components/parameters/content-type'
      - $ref: '#/components/parameters/etag'
      - $ref: '#/components/parameters/include'
      - $ref: '#/components/parameters/exclude'
      - $ref: '#/components/parameters/features'
      - $ref: '#/components/parameters/freeform'
      - $ref: '#/components/parameters/street'
      - $ref: '#/components/parameters/city'
      - $ref: '#/components/parameters/state'
      - $ref: '#/components/parameters/zipcode'
      responses:
        '200':
          $ref: '#/components/responses/SecondaryCountResponseSearch'
        '304':
          $ref: '#/components/responses/NotModified'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '413':
          $ref: '#/components/responses/RequestTooLarge'
        '422':
          $ref: '#/components/responses/UnprocessableContent'
        '429':
          $ref: '#/components/responses/TooManyRequests'
components:
  schemas:
    SecondaryCountResponseSmartyKey:
      type: object
      properties:
        smarty_key:
          type: string
        count:
          type: integer
    Alias:
      type: object
      properties:
        smarty_key:
          type: string
        primary_number:
          type: number
        street_name:
          type: string
        street_suffix:
          type: string
        street_postdirection:
          type: string
        city_name:
          type: string
        state_abbreviation:
          type: string
        zipcode:
          type: number
        plus4_code:
          type: number
    SecondaryResponseSmartyKey:
      type: object
      properties:
        smarty_key:
          type: string
        root_address:
          $ref: '#/components/schemas/RootAddress'
        aliases:
          type: array
          items:
            $ref: '#/components/schemas/Alias'
        secondaries:
          type: array
          items:
            $ref: '#/components/schemas/Secondaries'
    Secondaries:
      type: object
      properties:
        smarty_key:
          type: string
        secondary_designator:
          type: string
        secondary_number:
          type: string
        plus4_code:
          type: string
    PropertyResponseSearch:
      properties:
        smarty_key:
          type: string
        data_set_name:
          type: string
        data_subset_name:
          type: string
        matched_address:
          $ref: '#/components/schemas/MatchedAddress'
        attributes:
          oneOf:
          - allOf:
            - $ref: '#/components/schemas/GroupStructuralAttributes'
            - $ref: '#/components/schemas/GroupLocationAttributes'
          - $ref: '#/components/schemas/GroupFinancialAttributes'
    SecondaryCountResponseSearch:
      type: object
      properties:
        smarty_key:
          type: string
        matched_address:
          $ref: '#/components/schemas/MatchedAddress'
        count:
          type: integer
    Place:
      type: object
      description: The Bureau of the Census defines a place as a concentration of population. It consists of a geographical boundary.
      properties:
        accuracy:
          type: string
          description: Represents the accuracy of the geocode associated with the SmartyKey. Less than Zip9 accuracy will be inferred. Otherwise, it will be exact.
        code:
          type: string
          description: A 7-digit code that identifies the place. The first 2 digits identify the state. The last 5 identify the place within the state.
        name:
          type: string
          description: The name of the place boundary.
        type:
          type: string
          description: Indicates if the Census Place is incorporated or unincorporated.
    CoreBasedStatArea:
      type: object
      description: Refers collectively to metropolitan statistical areas and micropolitan statistical areas. CBSAs consist of the county or counties (or equivalent entities) associated with at least one core (urban area) with a population of at least 10,000, plus adjacent counties having a high degree of social and economic integration with the core as measured through commuting ties.
      properties:
        code:
          type: string
          description: A 5-digit unique id of the CBSA (e.g. 39340)
        name:
          type: string
          description: The name of the CBSA (e.g. Provo-Orem, UT)
    FinancialHistoryEntry:
      type: array
      items:
        properties:
          code_title_company:
            type: string
          document_type_description:
            type: string
          instrument_date:
            type: string
          interest_rate_type_2:
            type: string
          lender_address:
            type: string
          lender_address_2:
            type: string
          lender_city:
            type: string
          lender_city_2:
            type: string
          lender_code_2:
            type: string
          lender_first_name:
            type: string
          lender_first_name_2:
            type: string
          lender_last_name:
            type: string
          lender_last_name_2:
            type: string
          lender_name:
            type: string
          lender_name_2:
            type: string
          lender_seller_carry_back:
            type: string
          lender_seller_carry_back_2:
            type: string
          lender_state:
            type: string
          lender_state_2:
            type: string
          lender_zip:
            type: string
          lender_zip_2:
            type: string
          lender_zip_extended:
            type: string
          lender_zip_extended_2:
            type: string
          mortgage_amount:
            type: string
          mortgage_amount_2:
            type: string
          mortgage_due_date:
            type: string
          mortgage_due_date_2:
            type: string
          mortgage_interest_rate:
            type: string
          mortgage_interest_rate_type:
            type: string
          mortgage_lender_code:
            type: string
          mortgage_rate_2:
            type: string
          mortgage_recording_date:
            type: string
          mortgage_recording_date_2:
            type: string
          mortgage_term:
            type: string
          mortgage_term_2:
            type: string
          mortgage_term_type:
            type: string
          mortgage_term_type_2:
            type: string
          mortgage_type:
            type: string
          mortgage_type_2:
            type: string
          multi_parcel_flag:
            type: string
          name_title_company:
            type: string
          recording_date:
            type: string
          transfer_amount:
            type: string
    GroupFinancialAttributes:
      type: object
      description: Financial attributes in the Financial Dataset records.
      properties:
        assessed_improvement_percent:
          type: string
        assessed_improvement_value:
          type: string
        assessed_land_value:
          type: string
        assessed_value:
          type: string
        assessor_last_update:
          type: string
        assessor_taxroll_update:
          type: string
        code_title_company:
          type: string
        company_flag:
          type: string
        contact_city:
          type: string
        contact_crrt:
          type: string
        contact_full_address:
          type: string
        contact_house_number:
          type: string
        contact_mail_info_format:
          type: string
        contact_mailing_county:
          type: string
        contact_mailing_fips:
          type: string
        contact_post_direction:
          type: string
        contact_pre_direction:
          type: string
        contact_state:
          type: string
        contact_street_name:
          type: string
        contact_suffix:
          type: string
        contact_unit_designator:
          type: string
        contact_value:
          type: string
        contact_zip:
          type: string
        contact_zip4:
          type: string
        deed_document_page:
          type: string
        deed_document_book:
          type: string
        deed_document_number:
          type: string
        deed_owner_first_name:
          type: string
        deed_owner_first_name2:
          type: string
        deed_owner_first_name3:
          type: string
        deed_owner_first_name4:
          type: string
        deed_owner_full_name:
          type: string
        deed_owner_full_name2:
          type: string
        deed_owner_full_name3:
          type: string
        deed_owner_full_name4:
          type: string
        deed_owner_last_name:
          type: string
        deed_owner_last_name2:
          type: string
        deed_owner_last_name3:
          type: string
        deed_owner_last_name4:
          type: string
        deed_owner_middle_name:
          type: string
        deed_owner_middle_name2:
          type: string
        deed_owner_middle_name3:
          type: string
        deed_owner_middle_name4:
          type: string
        deed_owner_suffix:
          type: string
        deed_owner_suffix2:
          type: string
        deed_owner_suffix3:
          type: string
        deed_owner_suffix4:
          type: string
        deed_sale_date:
          type: string
        deed_sale_price:
          type: string
        deed_transaction_id:
          type: string
        disabled_tax_exemption:
          type: string
        financial_history:
          $ref: '#/components/schemas/FinancialHistoryEntry'
        first_name:
          type: string
        first_name_2:
          type: string
        first_name_3:
          type: string
        first_name_4:
          type: string
        homeowner_tax_exemption:
          type: string
        instrument_date:
          type: string
        interest_rate:
          type: string
        interest_rate_type_2:
          type: string
        last_name:
          type: string
        last_name_2:
          type: string
        last_name_3:
          type: string
        last_name_4:
          type: string
        lender_address:
          type: string
        lender_address_2:
          type: string
        lender_city:
          type: string
        lender_city_2:
          type: string
        lender_code_2:
          type: string
        lender_first_name:
          type: string
        lender_first_name_2:
          type: string
        lender_last_name:
          type: string
        lender_last_name_2:
          type: string
        lender_name:
          type: string
        lender_name_2:
          type: string
        lender_seller_carry_back:
          type: string
        lender_seller_carry_back_2:
          type: string
        lender_state:
          type: string
        lender_state_2:
          type: string
        lender_zip:
          type: string
        lender_zip_2:
          type: string
        lender_zip_extended:
          type: string
        lender_zip_extended_2:
          type: string
        loan_amount:
          type: string
        market_improvement_percent:
          type: string
        market_improvement_value:
          type: string
        market_land_value:
          type: string
        market_value_year:
          type: string
        middle_name:
          type: string
        middle_name_2:
          type: string
        middle_name_3:
          type: string
        middle_name_4:
          type: string
        mortgage_amount_2:
          type: string
        mortgage_due_date:
          type: string
        mortgage_due_date_2:
          type: string
        mortgage_interest_type:
          type: string
        mortgage_lender_code:
          type: string
        mortgage_start_date:
          type: string
        mortgage_start_date_2:
          type: string
        mortgage_term:
          type: string
        mortgage_term_2:
          type: string
        mortgage_term_type:
          type: string
        mortgage_term_type_2:
          type: string
        mortgage_type:
          type: string
        mortgage_type_2:
          type: string
        mortgage_rate_2:
          type: string
        multi_parcel_flag:
          type: string
        name_title_company:
          type: string
        other_tax_exemption:
          type: string
        owner_full_name:
          type: string
        owner_full_name_2:
          type: string
        owner_full_name_3:
          type: string
        owner_full_name_4:
          type: string
        owner_occupancy_status:
          type: string
        ownership_transfer_date:
          type: string
        ownership_transfer_doc_number:
          type: string
        ownership_transfer_transaction_id:
          type: string
        ownership_type:
          type: string
        ownership_type_2:
          type: string
        ownership_vesting_relation_code:
          type: string
        previous_assessed_value:
          type: string
        prior_sale_amount:
          type: string
        prior_sale_date:
          type: string
        sale_amount:
          type: string
        sale_date:
          type: string
        sale_price:
          type: string
        senior_tax_exemption:
          type: string
        suffix:
          type: string
        suffix_2:
          type: string
        suffix_3:
          type: string
        suffix_4:
          type: string
        tax_assess_year:
          type: string
        tax_billed_amount:
          type: string
        tax_delinquent_year:
          type: string
        tax_fiscal_year:
          type: string
        tax_rate_area:
          type: string
        total_market_value:
          type: string
        trust_description:
          type: string
        veteran_tax_exemption:
          type: string
        widow_tax_exemption:
          type: string
    CensusTract:
      type: string
      description: Geographic entities within counties (or the statistical equivalent of counties).
      properties:
        code:
          type: string
          description: Census tracts within a county are identified by a 4-digit basic code between 0001 and 9999, and may have a 2-digit suffix ranging from .01 to .98; (e.g. 6059.02)
    GroupLocationAttributes:
      type: object
      description: Location attributes in the Principal Dataset records.
      properties:
        block1:
          type: string
        block2:
          type: string
        carrier_route_code:
          type: string
        cbsa_code:
          type: string
        cbsa_name:
          type: string
        census_block:
          type: string
        census_block_group:
          type: string
        census_fips_place_code:
          type: string
        census_tract:
          type: string
        city:
          type: string
        combined_statistical_area:
          type: string
        congressional_district:
          type: string
        elevation_feet:
          type: string
        fips_code:
          type: string
        geo_quality:
          type: string
        house_number:
          type: string
        land_use_code:
          type: string
        land_use_group:
          type: string
        land_use_standard:
          type: string
        latitude:
          type: string
        legal_description:
          type: string
        legal_unit:
          type: string
        longitude:
          type: string
        lot_1:
          type: string
        lot_2:
          type: string
        lot_3:
          type: string
        metro_division:
          type: string
        minor_civil_division_code:
          type: string
        minor_civil_division_name:
          type: string
        msa_code:
          type: string
        msa_name:
          type: string
        neighborhood_code:
          type: string
        parcel_account_number:
          type: string
        parcel_map_book:
          type: string
        parcel_map_page:
          type: string
        parcel_number_alternate:
          type: string
        parcel_number_formatted:
          type: string
        parcel_number_previous:
          type: string
        parcel_number_year_added:
          type: string
        parcel_number_year_change:
          type: string
        parcel_raw_number:
          type: string
        phase_name:
          type: string
        post_direction:
          type: string
        pre_direction:
          type: string
        property_address_full:
          type: string
        quarter:
          type: string
        quarter_quarter:
          type: string
        range:
          type: string
        section:
          type: string
        situs_county:
          type: string
        situs_state:
          type: string
        state:
          type: string
        street_name:
          type: string
        street_predirection:
          type: string
        street_postdirection:
          type: string
        street_suffix:
          type: string
        subdivision:
          type: string
        tax_jurisdiction:
          type: string
        township:
          type: string
        tract_number:
          type: string
        unit_designator:
          type: string
        unit_value:
          type: string
        zip_4:
          type: string
        zipcode:
          type: string
        zoning:
          type: string
    SecondaryResponseSearch:
      type: object
      properties:
        smarty_key:
          type: string
        matched_address:
          $ref: '#/components/schemas/MatchedAddress'
        root_address:
          $ref: '#/components/schemas/RootAddress'
        aliases:
          type: array
          items:
            $ref: '#/components/schemas/Alias'
        secondaries:
          type: array
          items:
            $ref: '#/components/schemas/Secondaries'
    CensusBlockAndTractResponseSmartyKey:
      properties:
        smarty_key:
          type: string
        data_set_name:
          type: string
        data_set_version:
          type: string
        attributes:
          type: object
          properties:
            census_block:
              $ref: '#/components/schemas/CensusBlock'
            census_county_division:
              $ref: '#/components/schemas/CensusCountyDivision'
            census_tract:
              $ref: '#/components/schemas/CensusTract'
            core_based_stat_area:
              $ref: '#/components/schemas/CoreBasedStatArea'
            place:
              $ref: '#/components/schemas/Place'
    GroupStructuralAttributes:
      type: object
      description: Structural attributes in the Principal Dataset records.
      properties:
        1st_floor_sqft:
          type: string
        2nd_floor_sqft:
          type: string
        acres:
          type: string
        air_conditioner:
          type: string
        arbor_pergola:
          type: string
        attic_area:
          type: string
        attic_flag:
          type: string
        balcony:
          type: string
        balcony_area:
          type: string
        basement_sqft:
          type: string
        basement_sqft_finished:
          type: string
        basement_sqft_unfinished:
          type: string
        bath_house:
          type: string
        bath_house_sqft:
          type: string
        bathrooms_partial:
          type: string
        bathrooms_total:
          type: string
        bedrooms:
          type: string
        boat_access:
          type: string
        boat_house:
          type: string
        boat_house_sqft:
          type: string
        boat_lift:
          type: string
        bonus_room:
          type: string
        breakfast_nook:
          type: string
        breezeway:
          type: string
        building_definition_code:
          type: string
        building_sqft:
          type: string
        cabin:
          type: string
        cabin_sqft:
          type: string
        canopy:
          type: string
        canopy_sqft:
          type: string
        carport:
          type: str

# --- truncated at 32 KB (48 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/smarty/refs/heads/main/openapi/smarty-us-enrichment-api-openapi.yml