The Qismah Public API gives you token-based access to your ledgers, expenses, members, and supported currencies.
Public API access is included with Qismah Plus. If Plus expires, existing API tokens remain visible in settings but API requests return 402 PLUS_REQUIRED.

Read ledgers

List ledgers, inspect members, and fetch expenses with filters.

Create expenses

Add expenses with equal, exact, percentage, or share-based splits.

Currencies

Fetch supported currency codes.

​
Base URL

https://qismah.app/api/public/v1

​
First request

Create an API token in the app from Settings -> API tokens, then call GET /me. 
curl https://qismah.app/api/public/v1/me \
  -H "Authorization: Bearer qpk_your_token"
You can also send the token through x-api-key: 
x-api-key: qpk_your_token
API tokens are shown once. Store them like passwords and revoke any token you no longer use.

​
Amounts

Money values are sent as integer minor units in amountCents. For example, SAR 100.50 is 10050.

​
OpenAPI

The API reference is generated from openapi.json in this Mintlify project. Use it to generate clients or inspect request and response shapes.