List cases

Support cases with status, priority, group, owner and contact.

GET https://cotlet.dev/api/v1/vtiger/cases

read

Lists one page of cases from Main Menu > Support > Cases. status is one of New, Assigned, Open, Wait for 3rd party, Wait for customer, Resolved or Closed, and priority one of Urgent, High, Medium or Low. group is the team the case is assigned to. Pass next_cursor back as cursor for the next page.

Parameters

Parameters: list_cases
NameTypeDescription
status enum enum New, Assigned, Open, Wait for 3rd party, Wait for customer, Resolved or Closed.
priority enum enum Urgent, High, Medium or Low.
group string string Only cases assigned to this group.
assigned_to string string Only cases assigned to this user.
limit integer integer Cases per page.
cursor string string Next page cursor from the previous call.

Request

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

Example response

JSON

{
  "cases": [
    {
      "record_id": "3318",
      "title": "Invoice 1042 charged twice",
      "status": "New",
      "priority": "Medium",
      "group": "Support",
      "assigned_to": null,
      "contact": "Dana Whitfield",
      "created_at": "2026-10-22 08:14"
    },
    {
      "record_id": "3319",
      "title": "Cannot log in to the customer portal",
      "status": "New",
      "priority": "Medium",
      "group": "Support",
      "assigned_to": null,
      "contact": "Luis Ortega",
      "created_at": "2026-10-22 08:31"
    }
  ],
  "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.