Public API coming soon

The Farthingly REST API is in development. This page is a preview of what's planned. Join the waitlist to be notified when API access launches.

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"
  }'

Want early API access?

We're rolling out API access gradually. Get in touch and we'll add you to the list.

Request access