API Reference

SplitChey API

Build on top of SplitChey with our RESTful API. Manage expenses, groups, and settlements programmatically.

Request API Access Read Docs

Base URL

https://api.splitchey.com/v1

Authentication

API Key

Simple key-based auth for server-to-server calls. Pass in the X-API-Key header.

X-API-Key: sk_live_your_api_key

OAuth 2.0

For third-party apps accessing user data. Supports authorization code and PKCE flows.

Authorization: Bearer <access_token>

JWT Tokens

Short-lived tokens for session-based auth. Refresh tokens available.

Authorization: Bearer <jwt_token>

Endpoints

GET/api/v1/expensesList all expenses for the authenticated user

POST/api/v1/expensesCreate a new expense entry

GET/api/v1/expenses/:idGet a specific expense by ID

PUT/api/v1/expenses/:idUpdate an existing expense

DELETE/api/v1/expenses/:idDelete an expense

GET/api/v1/groupsList all groups the user belongs to

POST/api/v1/groupsCreate a new group

POST/api/v1/groups/:id/membersAdd a member to a group

GET/api/v1/groups/:id/expensesList all expenses in a group

GET/api/v1/settlementsList pending settlements across all groups

POST/api/v1/settlements/:id/confirmConfirm a settlement as paid

GET/api/v1/analytics/summaryGet spending summary and analytics

SDKs & Libraries

JavaScript / TypeScript

npm install @splitchey/sdk

Python

pip install splitchey

Go

go get github.com/splitchey/sdk-go

React Native

npm install @splitchey/react-native

Rate Limits

Free

100 requests

requests / min

Pro

1,000 requests

requests / min

Enterprise

10,000 requests

requests / min

Ready to build?

Request API access and start integrating SplitChey into your applications

Request Access