Lead-Status

GET https://leads.qreq.com/api/lead-statuses
curl --request GET \
--url 'https://leads.qreq.com/api/lead-statuses' \
--header 'Authorization: Bearer {api_key}'
{ "message": "Lead statuses retrieved successfully.", "leadStatuses": { "current_page": 1, "data": [ { "id": 36, "name": "Lost", "color": "#EF4444", "description": null, "status": "active", "created_by": 9, "created_at": "2025-10-31T10:59:06.000000Z", "updated_at": "2025-10-31T10:59:06.000000Z" }, { "id": 35, "name": "Converted", "color": "#059669", "description": null, "status": "active", "created_by": 9, "created_at": "2025-10-31T10:59:06.000000Z", "updated_at": "2025-10-31T10:59:06.000000Z" }, { "id": 34, "name": "Proposal Sent", "color": "#8B5CF6", "description": null, "status": "active", "created_by": 9, "created_at": "2025-10-31T10:59:06.000000Z", "updated_at": "2025-10-31T10:59:06.000000Z" }, { "id": 33, "name": "Qualified", "color": "#10B981", "description": null, "status": "active", "created_by": 9, "created_at": "2025-10-31T10:59:06.000000Z", "updated_at": "2025-10-31T10:59:06.000000Z" }, { "id": 32, "name": "Contacted", "color": "#F59E0B", "description": null, "status": "active", "created_by": 9, "created_at": "2025-10-31T10:59:06.000000Z", "updated_at": "2025-10-31T10:59:06.000000Z" }, { "id": 31, "name": "New", "color": "#3B82F6", "description": null, "status": "active", "created_by": 9, "created_at": "2025-10-31T10:59:06.000000Z", "updated_at": "2025-10-31T10:59:06.000000Z" } ], "first_page_url": "https://leads.qreq.com/api/lead-statuses?page=1", "from": 1, "last_page": 1, "last_page_url": "https://leads.qreq.com/api/lead-statuses?page=1", "links": [ { "url": null, "label": "« Previous", "page": null, "active": false }, { "url": "https://leads.qreq.com/api/lead-statuses?page=1", "label": "1", "page": 1, "active": true }, { "url": null, "label": "Next »", "page": null, "active": false } ], "next_page_url": null, "path": "https://leads.qreq.com/api/lead-statuses", "per_page": 10, "prev_page_url": null, "to": 6, "total": 6 }, "filters": { "search": null, "status": null, "sort_field": null, "sort_direction": null, "per_page": null } }
POST https://leads.qreq.com/api/lead-statuses
Parameter Einzelheiten Beschreibung
name Erforderlich Zeichenfolge Lead status name
color Erforderlich Zeichenfolge Color code for lead status (e.g., #ff0000)
description Optional Zeichenfolge Optional description
status Optional Zeichenfolge Active or inactive. Defaults to active
curl --request POST \
--url 'https://leads.qreq.com/api/lead-statuses' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: application/json' \
--data-raw '{ "name": "New Lead", "color": "#ff0000", "description": "Initial stage", "status": "active" }'
{ "message": "Lead status created successfully.", "leadStatus": { "name": "test status", "color": "#ffffff", "description": "for test purpose", "status": "active", "created_by": 9, "updated_at": "2025-11-01T11:44:17.000000Z", "created_at": "2025-11-01T11:44:17.000000Z", "id": 139 } }
PUT https://leads.qreq.com/api/lead-statuses/{lead_status_id}
Parameter Einzelheiten Beschreibung
name Erforderlich Zeichenfolge Lead status name
color Erforderlich Zeichenfolge Color code for lead status
description Optional Zeichenfolge Optional description
status Optional Zeichenfolge Active or inactive
curl --request PUT \
--url 'https://leads.qreq.com/api/lead-statuses/{lead_status_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: application/json' \
--data-raw '{ "name": "Updated Lead", "color": "#00ff00", "description": "Updated description", "status": "inactive" }'
{ "message": "Lead status updated successfully.", "leadStatus": { "id": 139, "name": "test status", "color": "#ffffff", "description": "for test purpose", "status": "active", "created_by": 9, "created_at": "2025-11-01T11:44:17.000000Z", "updated_at": "2025-11-01T11:44:17.000000Z" } }
DELETE https://leads.qreq.com/api/lead-statuses/{lead_status_id}
curl --request DELETE \
--url 'https://leads.qreq.com/api/lead-statuses/{lead_status_id}' \
--header 'Authorization: Bearer {api_key}'
{ "message": "Lead status deleted successfully." }
PATCH https://leads.qreq.com/api/lead-statuses/{lead_status_id}/toggle-status
curl --request PATCH \
--url 'https://leads.qreq.com/api/lead-statuses/{lead_status_id}/toggle-status' \
--header 'Authorization: Bearer {api_key}'
{ "message": "Lead status status updated successfully.", "leadStatus": { "id": 146, "name": "test status", "color": "#ffffff", "description": "for test purpose", "status": "inactive", "created_by": 9, "created_at": "2025-11-01T11:51:37.000000Z", "updated_at": "2025-11-01T11:52:57.000000Z" } }