List deficiencies
List deficiencies found on inspections by severity, status, resolution or location.
GET https://cotlet.dev/api/v1/servicetrade/deficiencies
read
Returns the reference number, severity, status, resolution, description, proposed fix, asset, location and the date it was reported. Newest first is not guaranteed, so sort on reported_on when order matters.
Parameters
| Name | Type | Description |
|---|---|---|
| severity string | string | One of inoperable, deficient, suggested. |
| status string | string | One of new, invalid, verified, fixed. |
| resolution string | string | One of new, out_for_quote, notified, out_for_repair, fixed, rejected, invalid. |
| location_id integer | integer | Only deficiencies at this location. |
| quoted boolean | boolean | false returns only deficiencies that are not on a quote yet. |
| created_after string | string | ISO 8601 date or date-time; only deficiencies created on or after it. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/servicetrade/deficiencies \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("servicetrade", "list_deficiencies")const result = await cotlet.call('servicetrade', 'list_deficiencies');cotlet call servicetrade list_deficienciesExample response
{
"deficiencies": [
{
"id": 9031,
"ref_number": "D-9031",
"severity": "inoperable",
"status": "new",
"resolution": "new",
"title": "Inoperable - Fire pump controller",
"description": "Pressure switch failed on test.",
"proposed_fix": "Replace pressure switch and retest.",
"asset": "Fire pump controller",
"location": {
"id": 5120,
"name": "Harbor Point Mall"
},
"reported_on": "2026-10-21"
}
],
"next_cursor": null
}