Read one job lead
curl --request GET \
--url https://api.getbreezyapp.com/v1/job-leads/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.getbreezyapp.com/v1/job-leads/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.getbreezyapp.com/v1/job-leads/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": {
"id": "11111111-1111-4111-8111-000000001207",
"status": "converted",
"created_at": "2026-08-18T16:00:00Z",
"updated_at": "2026-09-08T19:00:00Z",
"summary": "Air conditioner stopped cooling.",
"request_type": "SERVICE",
"submitted_account_type": "Residential",
"submitted_service_type": null,
"submitted_job_type": {
"id": "11111111-1111-4111-8111-000000000301",
"name": "HVAC Service"
},
"source_text": "Booking Website",
"contact": {
"first_name": "Jordan",
"last_name": "Example",
"email_address": "jordan@example.invalid",
"phone_number": "+12025550123"
},
"service_address": {
"line_1": "123 Example Lane",
"line_2": null,
"city": "Los Angeles",
"state": "CA",
"postal_code": "90001"
},
"existing_location_id": null,
"job_id": "11111111-1111-4111-8111-000000000501"
},
"meta": {
"request_id": "11111111-1111-4111-8111-000000009999",
"generated_at": "2026-09-08T19:00:00Z",
"timezone": "America/Los_Angeles"
}
}{
"error": {
"code": "INVALID_REQUEST",
"message": "end_date must be later than start_date",
"request_id": "example-request",
"details": []
}
}{
"error": {
"code": "UNAUTHENTICATED",
"message": "A valid API key is required",
"request_id": "example-request",
"details": []
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Resource not found",
"request_id": "example-request",
"details": []
}
}{
"error": {
"code": "METHOD_NOT_ALLOWED",
"message": "This resource supports GET",
"request_id": "example-request",
"details": []
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Request limit exceeded",
"request_id": "example-request",
"details": []
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "Unable to complete request",
"request_id": "example-request",
"details": []
}
}JobLeads
Read one job lead
Submitted service requests with captured contact/address, free-form intake source, and recorded conversion state. A converted lead is not evidence of a sale; multiple leads can refer to one job.
GET
/
job-leads
/
{id}
Read one job lead
curl --request GET \
--url https://api.getbreezyapp.com/v1/job-leads/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.getbreezyapp.com/v1/job-leads/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.getbreezyapp.com/v1/job-leads/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": {
"id": "11111111-1111-4111-8111-000000001207",
"status": "converted",
"created_at": "2026-08-18T16:00:00Z",
"updated_at": "2026-09-08T19:00:00Z",
"summary": "Air conditioner stopped cooling.",
"request_type": "SERVICE",
"submitted_account_type": "Residential",
"submitted_service_type": null,
"submitted_job_type": {
"id": "11111111-1111-4111-8111-000000000301",
"name": "HVAC Service"
},
"source_text": "Booking Website",
"contact": {
"first_name": "Jordan",
"last_name": "Example",
"email_address": "jordan@example.invalid",
"phone_number": "+12025550123"
},
"service_address": {
"line_1": "123 Example Lane",
"line_2": null,
"city": "Los Angeles",
"state": "CA",
"postal_code": "90001"
},
"existing_location_id": null,
"job_id": "11111111-1111-4111-8111-000000000501"
},
"meta": {
"request_id": "11111111-1111-4111-8111-000000009999",
"generated_at": "2026-09-08T19:00:00Z",
"timezone": "America/Los_Angeles"
}
}{
"error": {
"code": "INVALID_REQUEST",
"message": "end_date must be later than start_date",
"request_id": "example-request",
"details": []
}
}{
"error": {
"code": "UNAUTHENTICATED",
"message": "A valid API key is required",
"request_id": "example-request",
"details": []
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Resource not found",
"request_id": "example-request",
"details": []
}
}{
"error": {
"code": "METHOD_NOT_ALLOWED",
"message": "This resource supports GET",
"request_id": "example-request",
"details": []
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Request limit exceeded",
"request_id": "example-request",
"details": []
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "Unable to complete request",
"request_id": "example-request",
"details": []
}
}Authorizations
Existing Breezy API key. Grants all published reads in its associated company. No app permission scopes.
Path Parameters
Response
Successful read. Clients ignore unrecognized response fields.