Partner API v1

Programmatic access to your org ledger

Create a partner account, get a scoped msp_… key, and read/write your organization’s own expenses, budgets, and recurring spend — the same data you see in the web app. Keys never access other people’s accounts.

Getting started

  1. Create a partner account for your organization (e.g. EASE NGO).
  2. Request a development or production key and the scopes you need.
  3. EasySpend staff approves the request and issues a msp_… key.
  4. Call /api/v1/ with Authorization: Bearer msp_… to write/read your org ledger.
  5. Sign in to the web app with the same partner account to view the same expenses and budgets in the UI.

Authentication

curl -H "Authorization: Bearer msp_YOUR_KEY" \
  https://www.easemoneyspent.com/api/v1/me/

Scopes

GET needs resource:read. POST / PATCH / DELETE need resource:write.

  • users:read Organization account — read
  • expenses:read Expenses — read
  • expenses:write Expenses — write
  • budgets:read Budgets — read
  • budgets:write Budgets — write
  • recurring:read Recurring expenses — read
  • recurring:write Recurring expenses — write
  • usage:read Usage stats — read

Endpoints

Organization account

users:read

Your partner organization account (the ledger the API key can access).

GET /api/v1/users/

https://www.easemoneyspent.com/api/v1/users/?page_size=1

Expenses

expenses:read expenses:write

Expense transactions on your organization ledger.

GET /api/v1/expenses/ · POST/PATCH/DELETE

https://www.easemoneyspent.com/api/v1/expenses/?original_currency=USD&page_size=25

Budgets

budgets:read budgets:write

Budget periods and spend progress on your organization ledger.

GET /api/v1/budgets/ · POST/PATCH/DELETE

https://www.easemoneyspent.com/api/v1/budgets/?is_active=true&page_size=25

Recurring expenses

recurring:read recurring:write

Recurring spend rules on your organization ledger.

GET /api/v1/recurring/ · POST/PATCH/DELETE

https://www.easemoneyspent.com/api/v1/recurring/?is_active=true&page_size=25

Usage stats

usage:read

Monthly credit usage for your organization account.

GET /api/v1/usage/

https://www.easemoneyspent.com/api/v1/usage/?page_size=5