Taxes - API Documentation

Retrieve all

Endpoint

GET https://leads.qreq.com/api/taxes

Example

curl --request GET \
--url 'https://leads.qreq.com/api/taxes' \
--header 'Authorization: Bearer {api_key}'

Response example

{ "status": "success", "message": "Taxes retrieved successfully.", "data": { "current_page": 1, "data": [ { "id": 1, "name": "VAT 15%", "rate": 15, "type": "percentage", "description": "Standard VAT", "status": "active", "created_by": 33, "created_at": "2025-11-03T07:10:10.000000Z", "updated_at": "2025-11-03T07:10:10.000000Z" } ], "first_page_url": "https://leads.qreq.com/api/taxes?page=1", "from": 1, "last_page": 1, "last_page_url": "https://leads.qreq.com/api/taxes?page=1", "links": [], "next_page_url": null, "path": "https://leads.qreq.com/api/taxes", "per_page": 10, "prev_page_url": null, "to": 1, "total": 1 } }

Create

Endpoint

POST https://leads.qreq.com/api/taxes

Parameters	Details	Description
name	RequiredString	Tax name
rate	RequiredNumeric	Rate of tax (numeric)
type	OptionalString	percentage or fixed
description	OptionalString	Optional description
status	RequiredString	Active or inactive

Example

curl --request POST \
--url 'https://leads.qreq.com/api/taxes' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: application/json' \
--data-raw '{ "name": "VAT 15%", "rate": 15, "type": "percentage", "description": "Standard VAT", "status": "active" }'

Response example

{ "status": "success", "message": "Tax created successfully.", "data": { "id": 1, "name": "VAT 15%", "rate": 15, "type": "percentage", "description": "Standard VAT", "status": "active", "created_by": 33, "created_at": "2025-11-03T07:10:10.000000Z", "updated_at": "2025-11-03T07:10:10.000000Z" } }

Update

Endpoint

PUT https://leads.qreq.com/api/taxes/{tax_id}

Parameters	Details	Description
name	RequiredString	Tax name
rate	RequiredNumeric	Rate of tax (numeric)
type	OptionalString	percentage or fixed
description	OptionalString	Optional description
status	RequiredString	Active or inactive

Example

curl --request PUT \
--url 'https://leads.qreq.com/api/taxes/{tax_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: application/json' \
--data-raw '{ "name": "VAT 18%", "rate": 18, "type": "percentage", "description": "Updated VAT", "status": "active" }'

Response example

{ "status": "success", "message": "Tax updated successfully.", "data": { "id": 1, "name": "VAT 18%", "rate": 18, "type": "percentage", "description": "Updated VAT", "status": "active", "created_by": 33, "created_at": "2025-11-03T07:10:10.000000Z", "updated_at": "2025-11-03T07:12:02.000000Z" } }

Delete

Endpoint

DELETE https://leads.qreq.com/api/taxes/{tax_id}

Example

curl --request DELETE \
--url 'https://leads.qreq.com/api/taxes/{tax_id}' \
--header 'Authorization: Bearer {api_key}'

Response example

{ "status": "success", "message": "Tax deleted successfully." }

Toggle Status

Endpoint

PATCH https://leads.qreq.com/api/taxes/{tax_id}/toggle-status

Example

curl --request PATCH \
--url 'https://leads.qreq.com/api/taxes/{tax_id}/toggle-status' \
--header 'Authorization: Bearer {api_key}'

Response example

{ "status": "success", "message": "Tax status updated successfully.", "data": { "id": 1, "name": "VAT 15%", "rate": 15, "type": "percentage", "description": "Standard VAT", "status": "inactive", "created_by": 33, "created_at": "2025-11-03T07:10:10.000000Z", "updated_at": "2025-11-03T07:14:31.000000Z" } }