Estimates

Estimates provide price quotes to customers before work begins, helping formalize agreements and set expectations.

Create Estimate

POST https://api.invoiless.com/v1/estimates

Create a new estimate using the same fields as invoices.

Example:

{
  "customer": {
    "internalId": "INTERNAL_USER_ID",
    "billTo": {
      "company": "Invoiless"
    }
  },
  "items": [
    {
      "name": "Consulting Service",
      "quantity": 10,
      "price": 150
    }
  ],
  "status": "Draft"
}

Body Parameters

Accepts the same parameters as Create Invoice.

Response HTTP/1.1 201 Created

Returns the created estimate object.

Update Estimate

PUT https://api.invoiless.com/v1/estimates/:id

PATCH https://api.invoiless.com/v1/estimates/:id

Update an existing estimate. See PUT vs PATCH for details on the differences.

Path Parameters

Name	Type	Description	Required
id	string	Estimate id	Yes

Body Parameters

Accepts the same parameters as Create Invoice.

Get Estimate

GET https://api.invoiless.com/v1/estimates/:id

Retrieve a specific estimate by ID.

Path Parameters

Name	Type	Description	Required
id	string	Estimate id	Yes

Get Estimates

GET https://api.invoiless.com/v1/estimates

Retrieve a paginated list of all estimates.

Query Parameters

Name	Type	Description	Required
page	number	Page number	No, default is 1
limit	number	Page limit	No , default is 50
search	string	Search by estimate number, customer name, or tags	No

Send Estimate

POST https://api.invoiless.com/v1/estimates/:id/send

Send an estimate via email to the customer.

Path Parameters

Name	Type	Description	Required
id	string	Estimate id	Yes

Body Parameters

Name	Type	Description	Required
email	string	Email address	No
subject	string	Email subject	No
body	string	Email body	No
date	date	Schedule send	No

Export Estimate

GET https://api.invoiless.com/v1/estimates/:id/export

Export an estimate as PDF.

Path Parameters

Name	Type	Description	Required
id	string	Estimate id	Yes

Query Parameters

Name	Type	Description	Required
tz	string	IANA time zone used to render dates, e.g. Europe/Paris	No

Delete Estimate

DELETE https://api.invoiless.com/v1/estimates/:id

Permanently delete an estimate.

Path Parameters

Name	Type	Description	Required
id	string	Estimate id	Yes