Search service records

List the records in your SysAid queue that match a text search and filters.

GET https://cotlet.dev/api/v1/sysaid/service-records/search

read

Returns one page of records with ID, type, title, status, priority, assignee, requester, due date and creation time, plus next_cursor while more remain. Filters combine: a record must match all of them, as with column filters in the queue. Your agent sees the records your SysAid account can see.

Parameters

Parameters: search_service_records
NameTypeDescription
query string string Text to find in ID, title, description and notes, like the search field above the queue.
type string string incident, request, problem or change.
status string string Status name as list_field_values returns it, for example Open or Pending.
priority string string Priority name as list_field_values returns it.
assignee string string Name of an agent from list_agents_and_groups, or unassigned.
created_since string string ISO date. Only records created on or after it.
sort_by string string A queue column name, for example Due Date or Priority. Sorted ascending unless sort_dir is desc.
sort_dir string string asc or desc.
cursor string string Next page cursor from the previous call.

Request

cURL
curl https://cotlet.dev/api/v1/sysaid/service-records/search \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("sysaid", "search_service_records")
Node.js
const result = await cotlet.call('sysaid', 'search_service_records');
CLI
cotlet call sysaid search_service_records

Example response

JSON

{
  "records": [
    {
      "id": 48230,
      "type": "incident",
      "title": "VPN drops every hour",
      "status": "Open",
      "priority": "Priority 2",
      "assignee": null,
      "request_user": "Lena Ortiz",
      "due_date": "2026-10-26T17:00:00Z",
      "created_at": "2026-10-22T21:14:00Z"
    },
    {
      "id": 48244,
      "type": "request",
      "title": "New laptop for onboarding",
      "status": "Open",
      "priority": "Priority 3",
      "assignee": null,
      "request_user": "Sam Okafor",
      "due_date": "2026-10-30T17:00:00Z",
      "created_at": "2026-10-23T06:02:00Z"
    }
  ],
  "next_cursor": null
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.