Skip to content

Reference Documentation

Complete reference materials for the Open To Close API Python client. This section provides detailed technical specifications, data formats, and system information.


📚 Available References

  • Exception Reference


    Complete documentation of all exception types and error handling patterns

    Exception Reference

  • Data Types


    Type definitions, enums, and data structure specifications

    Data Types Reference

  • Rate Limits


    API rate limiting policies, quotas, and best practices

    Rate Limits

  • Changelog


    Version history, breaking changes, and migration guides

    Changelog


🚀 Quick Reference

Common Data Types

from typing import Dict, List, Optional, Any

# Property data structure
PropertyData = Dict[str, Any]

# Contact data structure  
ContactData = Dict[str, Any]

# Standard API response
APIResponse = Dict[str, Any]

Exception Hierarchy

OpenToCloseAPIError (Base)
├── AuthenticationError
├── ValidationError
├── NotFoundError
├── RateLimitError
├── ServerError
└── NetworkError

Rate Limits

Resource Requests per Minute Burst Limit
Properties 1000 100
Contacts 1000 100
Agents 500 50
General 2000 200

🔍 How to Use This Section

For Developers: - Use Exception Reference to implement proper error handling - Refer to Data Types for request/response structures - Check Rate Limits when designing bulk operations

For System Administrators: - Monitor Rate Limits for capacity planning - Track Changelog for system updates

For API Consumers: - Follow Exception Reference for robust applications - Use Data Types for validation and testing


📋 Reference Standards

All reference documentation follows these standards:

  • Complete coverage of all API features
  • Executable examples where applicable
  • Version compatibility information
  • Migration guidance for breaking changes
  • Performance considerations and recommendations

🚀 Next Steps

  1. Start with Exceptions - Essential for error handling
  2. Review Data Types - Understand API structures
  3. Check Rate Limits - Plan your implementation
  4. Read Changelog - Stay updated on changes

Reference documentation provides the technical foundation for building robust applications with the Open To Close API.