API Documentation

Technical documentation for developers integrating with the Fitor API.

UNSTABLE API

The Fitor API is currently UNSTABLE and may change without notice.

Breaking changes can occur at any time. We recommend:

• Not building production integrations without contacting us first
• Monitoring our changelog for updates
• Testing thoroughly after any system updates

Overview

Fitor provides a REST API for programmatic access to property management data and operations.

API Type

Attribute	Value
Protocol	REST (JSON)
Authentication	OAuth 2.0 / Bearer Token
Format	JSON
Encoding	UTF-8

Base URL

https://api.fitor.fi/api

Getting Access

Request API Access

To obtain API credentials:

1. Contact us at [email protected]
2. Describe your integration use case
3. We will provide:
   • Client ID
   • Client Secret
   • OpenAPI 3 schema documentation

Authentication

All API requests require authentication via Bearer token:

Authorization: Bearer <your_access_token>

OpenAPI Schema

Full API documentation is available as an OpenAPI 3.0 specification.

To request the schema:

1. Email [email protected]
2. Include your organization name
3. Describe your integration needs
4. We will send the schema file

The schema includes:

• All available endpoints
• Request/response formats
• Data models
• Authentication details

Rate Limiting

Limit	Value
Requests per minute	60
Requests per hour	1000
Burst limit	10 requests/second

Rate limit headers are included in all responses:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1699999999

Available Modules

The API provides access to the following modules:

Module	Description
Rental	Properties, leases, tenants
Billing	Invoices, payments, accounts
Accounting	Vouchers, transactions, reports
Maintenance	Work orders, requests
Vendors	Supplier management
Documents	File management

Error Handling

HTTP Status Codes

Code	Meaning
200	Success
201	Created
400	Bad Request
401	Unauthorized
403	Forbidden
404	Not Found
422	Validation Error
429	Rate Limited
500	Server Error

Error Response Format

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request data",
    "details": [
      {
        "field": "email",
        "message": "Invalid email format"
      }
    ]
  }
}

Webhooks

Webhooks are available for real-time event notifications.

Contact [email protected] to configure webhooks for:

• Invoice created/paid
• Lease signed/terminated
• Work order completed
• Payment received

Support

Technical Support

For API-related questions:

• Email: [email protected]
• Response time: 1-2 business days

Changelog

API changes are communicated via:

• Email to registered developers
• Changelog in the API documentation

Terms of Use

By using the Fitor API, you agree to:

• Use the API only for authorized purposes
• Not exceed rate limits
• Not attempt to access unauthorized data
• Maintain security of your credentials

---

Contact Us

For API access, documentation, or support:

Email: [email protected]

Include:

• Your organization name
• Intended use case
• Contact information