# Hourtick Invoices API

**Canonical:** https://apis.io/apis/hourtick/hourtick-invoices-api/  
**Provider:** Hourtick — https://apis.io/providers/hourtick/  
**Base URL:** https://hourtick.com  
**Documentation:** https://hourtick.com/developers

Hourtick Invoices API is one of 13 APIs that [Hourtick](https://apis.io/providers/hourtick/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 2 JSON Schema definitions. Tagged areas include Invoices. The published artifact set on APIs.io includes an OpenAPI specification and 2 JSON Schemas.

Invoices through the workspace's own Stripe account (Stripe Connect). An admin connects Stripe in Settings; Stripe Invoicing issues, emails and collects each invoice; Hourtick takes no fee (Stripe's own fees apply). Lines come from billable time not invoiced yet, and sent time is locked as invoiced. Agents send on their own only inside an invoice mandate; otherwise the invoice waits for an admin's approval. Writes take an `idempotencyKey` (body) or `Idempotency-Key` header.

## Operations (14)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/payments` | The workspace's Stripe connection: connected, ready to send invoices, and… |
| PATCH | `/api/v1/payments` | VAT rate (basis points) and label, and default days until due (admins) |
| DELETE | `/api/v1/payments` | Stop sending invoices through the account (admins). |
| POST | `/api/v1/payments/connect` | Start or resume Stripe-hosted onboarding and get its one-time URL (admins… |
| POST | `/api/v1/invoices/preview` | What an invoice would contain: lines, VAT, total, and anything that stops… |
| GET | `/api/v1/invoices` | Invoices, newest first (admins; agents see their clients') |
| POST | `/api/v1/invoices` | Create an invoice from a client's billable time not invoiced yet and send it… |
| GET | `/api/v1/invoices/{id}` | One invoice with its lines, payment page and timesheet link |
| POST | `/api/v1/invoices/{id}/approve` | Approve an agent's invoice waiting outside its mandate, and send it (admins) |
| POST | `/api/v1/invoices/{id}/retry` | Send an invoice again that didn't reach Stripe (admins). |
| POST | `/api/v1/invoices/{id}/void` | Void an invoice (or discard one not sent); its time becomes billable again… |
| GET | `/api/v1/invoice-mandates` | What agents may invoice without approval (admins; an agent sees its own) |
| POST | `/api/v1/invoice-mandates` | Let an agent send invoices on its own: clients (empty: any it works on), most… |
| DELETE | `/api/v1/invoice-mandates/{id}` | Stop an invoice mandate; the agent's invoices wait for approval again (admins) |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/hourtick/openapi/hourtick-invoices-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/hourtick/json-schema/hourtick-time-entry-schema.json
- **JSONSchema** — https://artifacts.apis.io/hourtick/json-schema/hourtick-work-item-schema.json

## Other Hourtick APIs (12)

- [Hourtick API](https://apis.io/apis/hourtick/hourtick-api/)
- [Hourtick Account API](https://apis.io/apis/hourtick/hourtick-account-api/)
- [Hourtick Agents API](https://apis.io/apis/hourtick/hourtick-agents-api/)
- [Hourtick Billing API](https://apis.io/apis/hourtick/hourtick-billing-api/)
- [Hourtick Catalog API](https://apis.io/apis/hourtick/hourtick-catalog-api/)
- [Hourtick Chat API](https://apis.io/apis/hourtick/hourtick-chat-api/)
- [Hourtick Integrations API](https://apis.io/apis/hourtick/hourtick-integrations-api/)
- [Hourtick Notes and files API](https://apis.io/apis/hourtick/hourtick-notes-and-files-api/)
- [Hourtick Reports API](https://apis.io/apis/hourtick/hourtick-reports-api/)
- [Hourtick Tasks API](https://apis.io/apis/hourtick/hourtick-tasks-api/)
- [Hourtick Team API](https://apis.io/apis/hourtick/hourtick-team-api/)
- [Hourtick Time API](https://apis.io/apis/hourtick/hourtick-time-api/)

## Tags

Invoices

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/hourtick/hourtick-invoices-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/hourtick/.