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 | number | 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 |
|---|---|---|---|
string | Email address | No | |
| subject | string | Email subject | No |
| body | string | Email body | No |
| date | date | Schedule send | 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 |