API Documentation

Build powerful integrations with Farthingly. Our REST API lets you programmatically manage expenses, approvals, and reports.

API Features

RESTful API

Simple, predictable URLs and standard HTTP methods

OAuth 2.0

Secure authentication with API keys and tokens

JSON Responses

All responses are returned in JSON format

Webhooks

Real-time notifications for expense events

Base URL

https://api.farthingly.com/v1

Authentication

All API requests require authentication using an API key passed in the header:

Authorization: Bearer your_api_key_here

Endpoints

GET/v1/expensesList all expenses with optional filters

POST/v1/expensesCreate a new expense submission

GET/v1/expenses/:idRetrieve a specific expense by ID

PATCH/v1/expenses/:idUpdate an existing expense

POST/v1/expenses/:id/approveApprove an expense (managers only)

POST/v1/expenses/:id/rejectReject an expense with reason

GET/v1/usersList organization users

GET/v1/reports/summaryGet expense summary statistics

Example Request

curl -X POST https://api.farthingly.com/v1/expenses \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50000,
    "currency": "NGN",
    "category": "travel",
    "merchant": "Air Peace",
    "description": "Flight to Lagos",
    "date": "2026-03-10"
  }'

Ready to integrate?

Get your API keys from the dashboard and start building.

Get API Keys