API Reference

Complete REST API reference for the Sardis Payment OS. 47+ endpoints covering wallets, payments, mandates, treasury, cards, compliance, and more.

Base URL

https://api.sardis.sh/api/v2

All API requests require an API key in the Authorization header:

curl -H "Authorization: Bearer sk_..." https://api.sardis.sh/api/v2/wallets

Method	Path	Description
`POST`	`/payments/execute`	Execute a payment
`POST`	`/payments/mandate`	Execute via spending mandate
`GET`	`/payments/{id}`	Get payment details
`GET`	`/payments`	List payments

Method	Path	Description
`POST`	`/mandates`	Create a spending mandate
`GET`	`/mandates`	List mandates
`GET`	`/mandates/{id}`	Get mandate details
`POST`	`/mandates/{id}/check`	Check transaction against mandate
`POST`	`/mandates/{id}/revoke`	Revoke mandate

Method	Path	Description
`POST`	`/treasury/fund`	Fund from bank account (ACH)
`POST`	`/treasury/withdraw`	Withdraw to bank account
`GET`	`/treasury/balances`	Get treasury balances
`POST`	`/treasury/external-bank-accounts`	Link external bank account
`POST`	`/treasury/account-holders/sync`	Sync financial accounts

Method	Path	Description
`POST`	`/compliance/screen`	Screen address/merchant
`GET`	`/compliance/{id}`	Get screening result

Method	Path	Description
`GET`	`/audit/events`	List audit events
`GET`	`/audit/events/{id}`	Get audit event details

Code	Description
`400`	Bad request — invalid parameters
`401`	Unauthorized — invalid or missing API key
`403`	Forbidden — insufficient permissions
`404`	Not found
`409`	Conflict — duplicate idempotency key
`422`	Policy violation — transaction blocked by spending policy
`429`	Rate limited
`500`	Internal server error

Rate limit headers are included in every response:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1711234567

The full OpenAPI spec with interactive playground is available at:

https://api.sardis.sh/api/v2/docs