invoices

Create Invoice

Create a client invoice and get its shareable link. Two ways to bill: (a) pass explicit line_items, or (b) pass project_id or task_list_ids plus hourly_rate (quarter-hour billing from first→last verified completion per list) or flat_rate_per_list, and TaScan builds one line per list from VERIFIED work ("<list> — 7/7 tasks verified · Sep 1 · 1.25h"); lists with no completions are skipped. A single-list invoice also mints a client-facing Service Report (acknowledge → pay) and links it. Returns invoice number, totals, url, and the work it billed.

post/invoices

Request

  • Base URL: https://app.tascan.io/api/v1
  • URL: https://app.tascan.io/api/v1/invoices
  • Auth: HTTP bearer

Request body

client_namestring required

Bill-to name (person or company)

client_emailstring
client_phonestring
project_idstring

Bill every list in this project (auto line items)

task_list_idsstring[]

Bill just these lists (auto line items)

hourly_ratenumber

Dollars per hour for auto line items

flat_rate_per_listnumber

Dollars per list for auto line items (used when no hourly_rate)

min_hoursnumber

Minimum billable hours per list (e.g. 1)

tax_ratenumber

Fraction, e.g. 0.0825 for 8.25%

due_datestring

YYYY-MM-DD (default: 30 days out)

notesstring

Payment terms / thank-you shown on the invoice

company_namestring

Your company name on the attached Service Report (defaults to the org name)

attach_service_reportboolean

Mint + link a Service Report for single-list invoices (default true)

status'draft' | 'sent'

Default sent

Response

Success. JSON body: { data: ... } or an error object { error, message }.

Changes

No recorded changes to this operation across all 1 revision of this API.