Invoices - Mojave Docs

Invoices in Mojave represent billable documents tied to tracked time, flat rates, or custom charges. Invoices are always linked to a client and optionally a project, and can include any number of time entries.

You can create, customize, send, and track invoices programmatically via the API.

Invoice Object Overview

{
  "id": "inv_9283hfkd",
  "client_id": "cli_9382hks1",
  "project_id": "prj_482hdka1",
  "status": "draft",
  "issue_date": "2025-04-10",
  "due_date": "2025-04-20",
  "currency": "USD",
  "subtotal": 4500,
  "tax": 450,
  "total": 4950,
  "paid": false,
  "entries": ["te_001", "te_002", "te_003"],
  "created_at": "2025-04-10T13:45:00Z"
}

Fields

Field	Type	Description
`id`	string	Unique invoice ID (`inv_...`)
`client_id`	string	The client being invoiced
`project_id`	string	Optional – project this invoice is related to
`status`	string	`draft`, `sent`, `paid`, or `overdue`
`issue_date`	string	Date the invoice was issued (`YYYY-MM-DD`)
`due_date`	string	Payment deadline (`YYYY-MM-DD`)
`currency`	string	ISO currency code (`USD`, `EUR`, etc.)
`subtotal`	number	Sum before tax (in major currency unit)
`tax`	number	Tax amount, calculated based on client settings or overrides
`total`	number	Final invoice total
`paid`	boolean	Indicates if the invoice has been marked as paid
`entries`	array	List of associated `time_entry` IDs or manual line items
`created_at`	string	Timestamp of invoice creation (ISO 8601)

Create an Invoice

curl -X POST https://api.mojaveapp.com/v1/invoices \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "cli_9382hks1",
    "project_id": "prj_482hdka1",
    "due_date": "2025-04-20"
  }'

Mojave will automatically include all unbilled time entries for the given client/project.

Send an Invoice

POST /invoices/inv_9283hfkd/send

Mojave will send the invoice PDF to the client’s email address and update the status to sent.

Mark an Invoice as Paid

PATCH /invoices/inv_9283hfkd
{
  "paid": true
}

Invoice Statuses

Status	Description
`draft`	Created but not sent
`sent`	Delivered to the client
`paid`	Fully paid
`overdue`	Due date passed and not marked as paid

PDF Exports

GET /invoices/inv_9283hfkd/export

Returns a downloadable file with a Mojave-branded or custom template (if configured).

Tasks

Slack

Table of content