Developer Resources

Authorization: Bearer YOUR_API_KEY

# Authorization endpoint
https://auth.tryacre.io/oauth/authorize

# Token endpoint
https://auth.tryacre.io/oauth/token

# Example authorization URL
https://auth.tryacre.io/oauth/authorize?
  client_id=YOUR_CLIENT_ID&
  redirect_uri=YOUR_REDIRECT_URI&
  response_type=code&
  scope=properties:read tenants:read

curl -X GET https://api.tryacre.io/v1/properties \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "page": 1,
    "limit": 20,
    "status": "active"
  }'

import { AcreClient } from '@acre/sdk';

const acre = new AcreClient({
  apiKey: 'YOUR_API_KEY'
});

// Get all properties
const properties = await acre.properties.list({
  status: 'active',
  limit: 20
});

// Create a new tenant
const tenant = await acre.tenants.create({
  firstName: 'John',
  lastName: 'Doe',
  email: 'john@example.com',
  propertyId: 'prop_123'
});

{
  "id": "evt_1234567890",
  "type": "payment.received",
  "created": "2025-01-15T10:30:00Z",
  "data": {
    "payment_id": "pay_abc123",
    "amount": 1500.00,
    "currency": "USD",
    "tenant_id": "ten_xyz789",
    "property_id": "prop_123",
    "payment_method": "bank_transfer"
  }
}

// Schedule monthly rent collection
async function collectMonthlyRent() {
  const tenants = await acre.tenants.list({
    status: 'active',
    has_autopay: true
  });

  for (const tenant of tenants) {
    try {
      const payment = await acre.payments.create({
        tenant_id: tenant.id,
        amount: tenant.monthly_rent,
        type: 'rent',
        method: 'autopay'
      });
      
      console.log(`Collected rent from ${tenant.name}`);
    } catch (error) {
      console.error(`Failed to collect from ${tenant.name}:`, error);
    }
  }
}

import acre
from datetime import datetime

# Initialize client
client = acre.Client(api_key='YOUR_API_KEY')

# Create maintenance request with auto-assignment
def create_maintenance_request(property_id, issue_type, description):
    # Find available technician
    technician = client.technicians.find_available(
        skill=issue_type,
        location=property_id
    )
    
    # Create request
    request = client.maintenance.create(
        property_id=property_id,
        issue_type=issue_type,
        description=description,
        priority='high' if 'emergency' in description else 'normal',
        assigned_to=technician.id if technician else None
    )
    
    return request