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

# Address Lookup



## OpenAPI

````yaml /api-reference/openapi.json get /public/property/address/
openapi: 3.1.0
info:
  title: Property Data API
  description: API for looking up property details by address and unit number.
  version: 1.0.0
servers:
  - url: https://app.realie.ai/api
security: []
paths:
  /public/property/address/:
    get:
      tags:
        - Property
      summary: Address Lookup
      operationId: addressLookup
      parameters:
        - name: state
          in: query
          required: true
          schema:
            type: string
          description: The state (e.g. “CA”) where the property is located.
        - name: address
          in: query
          required: true
          schema:
            type: string
          description: >-
            The street address line 1 only (e.g. “123 Main Street”). Do not
            include city, state, or ZIP in this field.
        - name: unitNumberStripped
          in: query
          required: false
          schema:
            type: string
          description: >-
            The unit number of the property (optional). Do not include the type
            of unit. (e.g. “APT 2B” would just be “2B”)
        - name: county
          in: query
          required: false
          schema:
            type: string
          description: >-
            The county where the property is located. Required when city
            parameter is provided.
        - name: city
          in: query
          required: false
          schema:
            type: string
          description: >-
            The city where the property is located. If specified, county
            parameter is required.
      responses:
        '200':
          description: Property found successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  property:
                    type: object
                    description: The property features found.
        '400':
          description: Bad Request - Missing or invalid parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Description of the error that occurred.
                    example: >-
                      Bad Request: Both address and state are required
                      parameters
        '401':
          description: Unauthorized - Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Description of the error that occurred.
                    example: 'Unauthorized: API key is missing'
        '403':
          description: Forbidden - Usage limit exceeded
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Description of the error that occurred.
                    example: 'Forbidden: Usage limit exceeded'
        '404':
          description: Not Found - Address not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Description of the error that occurred.
                    example: Address not found
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Description of the error that occurred.
                    example: Internal Server Error
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      name: Authorization
      in: header
      description: Provide your API key directly in the header.

````