Arxa/Intelligence
API REFERENCE

Build on top of Arxa Intelligence

REST API and webhooks for cash positions, decisions, anomalies, and forecasts. Available on Scale and Enterprise plans.

REST

Simple JSON over HTTPS

Webhooks

Real-time event delivery

Secure

OAuth 2.0 + scoped API keys

AUTHENTICATION

Bearer token authentication

Authenticate every request by including your secret API key in the Authorization header as a Bearer token. Keys are scoped per workspace and can be rotated at any time from the dashboard. Use sk_test_* keys for sandbox and sk_live_* keys for production.

curl https://api.arxaintelligence.com/v1/cash-positions \
  -H "Authorization: Bearer sk_live_..." \
  -H "Accept: application/json"
ENDPOINTS

Example endpoints

A small selection of the most common endpoints. Full reference, parameters, error codes, and pagination details are available in the complete documentation.

GET/v1/cash-positions

Current cash position across all entities

{
  "total": 4827950.42,
  "currency": "EUR",
  "entities": 7,
  "as_of": "2026-05-04T08:00:00Z"
}
GET/v1/cash-positions/forecast?weeks=13

13-week rolling forecast

{
  "horizon_weeks": 13,
  "low_point": { "week": 6, "amount": 1820000 },
  "confidence": 0.92
}
GET/v1/decisions

AI-generated decisions for the day

{
  "data": [
    { "id": "dec_01J", "type": "sweep", "amount": 250000, "priority": "high" },
    { "id": "dec_02K", "type": "fx_hedge", "amount": 80000, "priority": "medium" }
  ]
}
POST/v1/decisions/:id/approve

Approve a decision and execute it

{
  "id": "dec_01J",
  "status": "approved",
  "executed_at": "2026-05-04T09:14:22Z"
}
GET/v1/anomalies?status=active

Active payment anomalies

{
  "data": [
    { "id": "anm_88Z", "score": 0.94, "reason": "vendor_mismatch", "amount": 12400 }
  ]
}
GET/v1/transactions?from=2026-01-01

Transaction history

{
  "data": [
    { "id": "txn_5821", "date": "2026-04-30", "amount": -4820.55, "counterparty": "AWS" }
  ],
  "next_cursor": "eyJwYWdlIjoyfQ"
}
WEBHOOKS

Real-time events

Subscribe to events to receive a signed HTTPS POST request the moment something happens. Each delivery is retried with exponential backoff for up to 24 hours.

transaction.created·New bank transaction synced
anomaly.detected·Suspicious payment flagged
decision.generated·New AI decision available
payment.scheduled·Payment scheduled for execution
subscription.updated·Plan or status changed

Sample payload

{
  "id": "evt_01HZX9KQ2P",
  "type": "anomaly.detected",
  "created_at": "2026-05-04T10:22:18Z",
  "data": {
    "anomaly_id": "anm_88Z",
    "score": 0.94,
    "amount": 12400,
    "currency": "EUR",
    "reason": "vendor_mismatch"
  }
}
SCALE & ENTERPRISE

Full API docs available on Scale and Enterprise plans

Full API documentation, OpenAPI spec, SDKs (Python, Node.js, Go), and 99.9% SLA are available on Scale and Enterprise plans.

RATE LIMITS & SLA

Throughput and availability

Scale
100 req/min

Generous throughput for production workloads, with burst tolerance.

Enterprise
1000 req/min

High-volume access for finance teams operating across many entities.

Enterprise SLA
99.9% uptime

Contractual availability with dedicated support and incident response.