API reference
Integrate Orkasa
with your stack.
Full REST API, real-time webhooks, OAuth 2.0 for portals. Semantic versioning, generous rate limit, stable contracts.
Authentication
Generate API keys from Settings → API. Each key has scopes (read, write, admin) and an associated brokerage_id.
curl https://api.orkasa.io/v1/properties \
-H "Authorization: Bearer ork_live_xxxxxxxxxxxxx" \
-H "Content-Type: application/json"Endpoints
- GETList brokerage properties. Supports filters by status, type, price.
/v1/properties - POSTCreate a new property. Returns the public URL for image uploads.
/v1/properties - GETGet a property by ID with all its fields and images.
/v1/properties/{id} - PATCHUpdate a property partially.
/v1/properties/{id} - POSTTrigger publication to selected portals with adapter spec.
/v1/properties/{id}/publish - GETList leads with scoring, status and assigned agent.
/v1/leads - POSTCreate a lead (typical use: integration with your website).
/v1/leads - PATCHMove between kanban states, change assignment.
/v1/leads/{id} - POSTTrigger a listing review with Claude Opus 4.7. Returns 3 variants + photo analysis.
/v1/ai/listing-review - POSTEnhance a photo with Gemini 2.5 Flash Image. Returns the result URL.
/v1/ai/photo-enhance - GETStatus of each integration (portal/social) for the brokerage.
/v1/integrations
Webhooks
Events signed with HMAC-SHA256 via X-Orkasa-Signature header. Exponential retries capped at 24h. Idempotency via event_id.
property.createdNew property created.
property.updatedProperty modified (includes changed field).
property.publishedProperty published on a specific portal.
property.unpublishedProperty unpublished or removed from a portal.
lead.createdNew lead captured (includes source).
lead.qualifiedLead moved to qualified.
lead.assignedLead reassigned to another agent.
compliance.kyc_requiredLead requires KYC to proceed.
compliance.match_alertPositive match on a sanctions list.
Rate limits and SLA
Solo / Team
300 req/min
Brokerage
3,000 req/min
Uptime
99.9% (Brokerage SLA)