Get a Laravel site's queues
Answers the jobs waiting in each queue of a Laravel site, and which queues a worker listens on. The figures are read on the site without running the application's code, and an answer is kept for up to a minute: checked_at says when it was read. Try-it is off because the read runs a command on the site.
Path parameters
The id of a site row. A website's production site and each of its environments has its own id. Digits only. At least 1.
Returns
200 The site's queues, largest first.
Fields of the 200 answer
When the figures were read. An answer may be up to a minute old. Format: date-time.
Where the queue settings were read from: cache (the application's cached configuration), cache_refused (a cached configuration that holds more than plain values, so the environment was read in its place), env or defaults.
cachecache_refusedenvdefaultsThe name of the queue connection the workers use (the application's queue.default).
The driver of the queue connection the workers use, such as database or redis.
The number of failed jobs, or null when it could not be counted.
The queues the site's workers listen on.
Fields
The queue names, or null when they are not known.
default: the connection's own queue. unknown: the queues could not be worked out.
defaultunknownAt most 50 queues, largest first.
Fields of each item
Jobs waiting for their time.
Whether a worker listens on the queue. Null when that is not known.
Whether a worker's queue list can name the queue: letters, digits, ., _, : and -, 1 to 64 characters.
When the oldest ready job became ready. The database driver only, else null. Format: date-time.
Jobs waiting for a worker now.
Jobs being worked.
True when the queue has jobs ready and no worker listens on it.
How long the oldest ready job has waited. The database driver only, else null.
Why state is unsupported: driver, database_driver, table_name or redis_connection. Null otherwise.
ok; unsupported (a driver or database whose jobs cannot be counted: reason says which); no_jobs_table (the application has not created its jobs table).
okunsupportedno_jobs_tableTrue when the site has more queues than are listed.
Queues left out because their name has control characters or is longer than 255 bytes.
The names of the queues with jobs ready and no worker listening.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | company_unavailable | Your company is unavailable. |
403 | scope_required | Use a token with the scope named in scope. |
403 | two_factor_required | Turn on two-factor on your account, then send again. |
404 | feature_off | This feature is not on for your organisation yet. |
404 | wrong_platform | This is not available for the site's platform. Use it on a site of the platform it is for. |
409 | busy | Another operation is running on the site. Wait for it to finish. |
409 | command_running | Another action or command is still running on the site. Wait for it to finish, then try again. |
409 | deployment_running | A deployment of the environment is running, or a stopped one is still being cleaned up. Wait for it to finish, then try again. |
409 | exec_unresolved | An earlier command on the site has not been confirmed stopped. Contact support. |
409 | install_running | An installer is still running on the site. Contact support. |
409 | not_running | The site, environment or deployment is not running. Read the message: where it can be started or will recover, start it or wait, then try again. |
409 | removed | The site or environment is being removed, or has been. Nothing can be changed on it. |
409 | restore_running | A restore is running on the site. Wait for it to finish, then try again. |
409 | site_unadopted | This site is not ready to be changed from the Control Panel yet. Contact support. |
429 | rate_limited | Wait for the seconds in Retry-After. |
502 | helper_failed | The site's database did not answer, so its queues could not be read. Try again in a moment. |
503 | connect_failed | The cluster could not be reached. |
503 | temporarily_unavailable | The Control Panel could not answer just now. Nothing was started; try again shortly. |
503 | switched_off | Corefinity has switched this action off for the moment. Try again later. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl https://manage.corefinity.com/api/corestack/sites/1042/laravel/queues \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->get('https://manage.corefinity.com/api/corestack/sites/1042/laravel/queues');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/laravel/queues', {
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);import os
import requests
res = requests.get(
"https://manage.corefinity.com/api/corestack/sites/1042/laravel/queues",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"checked_at": "2026-11-03T09:14:03Z",
"config_source": "cache",
"connection": "database",
"driver": "database",
"failed": 0,
"listening": {
"queues": [
"default"
],
"source": "default"
},
"queues": [
{
"delayed": 0,
"listened": false,
"name": "webhooks",
"name_supported": true,
"oldest_ready_at": "2026-11-03T09:00:00Z",
"ready": 40,
"reserved": 0,
"unworked": true,
"waiting_seconds": 843
},
{
"delayed": 0,
"listened": true,
"name": "default",
"name_supported": true,
"oldest_ready_at": "2026-11-03T09:13:20Z",
"ready": 1,
"reserved": 0,
"unworked": false,
"waiting_seconds": 43
}
],
"reason": null,
"state": "ok",
"truncated": false,
"unreadable_names": 0,
"unworked": [
"webhooks"
]
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "busy",
"message": "Another command is running on this site. Try again in a moment.",
"reason": "busy"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}{
"code": "helper_failed",
"helper": "database",
"message": "The site's database did not answer, so its queues could not be read. Try again in a moment.",
"reason": "helper_failed"
}{
"code": "connect_failed",
"message": "The cluster could not be reached",
"reason": "connect_failed"
}Try it is off for this endpointIt has not been cleared for the console. Copy the request and run it yourself when you are sure.