---
title: "List support tickets"
url: https://docs.corefinity.com/api/reference/support/list-support-tickets
type: endpoint
last_updated: 2026-11-13
feature: support
related:
  - https://docs.corefinity.com/guides/support/raise-and-follow-a-ticket.md
---
# List support tickets

Answers the tickets you can see (your company's, those of the companies your agency looks after and any you
follow) in the order of the Tickets page of the Control Panel: new tickets first, then open and in-progress
ones by priority, then the rest, newest first within each. Paged by page number: `page` and `per_page`.

```http
GET /api/support/tickets
```

- Scope: `read`
- Rate limit: 60 a minute
- Try it in the console: on

## Query parameters

- `status` (string): `all_open_with_waiting` (the default: every ticket that is not resolved or closed), `all_open` (new, open, in progress and on hold), `all`, or one or more statuses, comma-separated: `pending`, `open`, `in_progress`, `waiting_on_customer`, `waiting_on_thirdparty`, `on_hold`, `scheduled`, `resolved`, `closed`.
- `priority` (string): One or more of `emergency`, `high`, `medium` and `low`, comma-separated.
- `company_id` (integer): One company's tickets, for an agency with more than one company.
- `website_ids` (string): Tickets about any of these websites: up to 50 ids, comma-separated.
- `website_id` (integer): Tickets about one website.
- `environment_ids` (string): Tickets about any of these environments: up to 50 ids, comma-separated.
- `environment_id` (integer): Tickets about one environment.
- `requester_id` (integer): Tickets for that person.
- `department_id` (integer): Tickets in that department.
- `page` (integer): The page to read, starting at 1.
- `per_page` (integer): Items a page. Each endpoint names the sizes it accepts.

## Request

### curl

```bash
curl https://manage.corefinity.com/api/support/tickets \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
```

### PHP

```php
use Illuminate\Support\Facades\Http;

$response = Http::withToken(env('COREFINITY_TOKEN'))
    ->acceptJson()
    ->get('https://manage.corefinity.com/api/support/tickets');

$data = $response->json();
```

### Node

```javascript
const res = await fetch('https://manage.corefinity.com/api/support/tickets', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
    Accept: 'application/json',
  },
});

// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);
```

### Python

```python
import os
import requests

res = requests.get(
    "https://manage.corefinity.com/api/support/tickets",
    headers={
        "Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
        "Accept": "application/json",
    },
)

data = res.json() if res.content else None
```

## Responses

### 200 One page of tickets.

```json
{
  "last_page": 1,
  "page": 1,
  "per_page": 25,
  "tickets": [
    {
      "company": {
        "id": 1204,
        "name": "Harbour & Finch"
      },
      "created_at": "2026-11-02T08:14:03Z",
      "department": {
        "id": 21,
        "name": "Support"
      },
      "environment": {
        "id": 1311,
        "name": "Production"
      },
      "environments": [
        {
          "id": 1311,
          "name": "Production"
        }
      ],
      "id": 48210,
      "priority": "high",
      "priority_label": "High",
      "requester": {
        "email": "eleanor.finch@harbourandfinch.example.com",
        "id": 2041,
        "name": "Eleanor Finch"
      },
      "scheduled_for": null,
      "status": "waiting_on_customer",
      "status_label": "Waiting on customer",
      "subject": "Checkout returns a 502",
      "updated_at": "2026-11-03T16:40:11Z",
      "url": "https://manage.corefinity.com/resources/tickets/48210",
      "website": {
        "id": 1310,
        "name": "Harbour & Finch trade"
      },
      "websites": [
        {
          "id": 1310,
          "name": "Harbour & Finch trade"
        }
      ]
    }
  ],
  "total": 1
}
```

### 401 No token, or a token that is not valid.

```json
{
  "message": "Unauthenticated."
}
```

### 403 The token lacks the scope this endpoint needs. `scope` names it.

```json
{
  "code": "scope_required",
  "message": "This access token does not have the destructive scope this needs. Use a token with the destructive scope.",
  "reason": "scope_required",
  "scope": "destructive"
}
```

### 422 A parameter is not valid. `field` names it.

```json
{
  "code": "invalid",
  "errors": {
    "per_page": [
      "The per page may not be greater than 100."
    ]
  },
  "field": "per_page",
  "message": "The per page may not be greater than 100.",
  "reason": "invalid"
}
```

### 429 Too many requests (`rate_limited`). Wait for the number of seconds in `Retry-After`, which `retry_after_seconds` repeats.

```json
{
  "code": "rate_limited",
  "message": "Too many requests. Try again in 60 seconds.",
  "reason": "rate_limited",
  "retry_after_seconds": 60
}
```

## If it is refused

| Status | Reason | What to do |
|---|---|---|
| 401 |  | Send a valid token as `Authorization: Bearer <token>`. |
| 403 | `scope_required` | Use a token with the scope named in `scope`. |
| 422 | `invalid` | Fix the field named in `field`; `errors` says why. |
| 429 | `rate_limited` | Wait for the seconds in `Retry-After`. |

## The same task elsewhere

- Guide: [Support tickets](https://docs.corefinity.com/guides/support/raise-and-follow-a-ticket.md)
