CorefinityCorefinityDocs
Open the Control PanelControl Panel
Laravel queues · 1 of 1

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.

GET/api/corestack/sites/{site}/laravel/queues

Path parameters

siteintegerRequired

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
checked_atstringRequired

When the figures were read. An answer may be up to a minute old. Format: date-time.

config_sourcestringRequired

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_refusedenvdefaults
connectionstringRequired

The name of the queue connection the workers use (the application's queue.default).

driverstringRequired

The driver of the queue connection the workers use, such as database or redis.

failedinteger or nullRequired

The number of failed jobs, or null when it could not be counted.

listeningobjectRequired

The queues the site's workers listen on.

Fields
queuesarray of strings or any or nullRequired

The queue names, or null when they are not known.

sourcestringRequired

default: the connection's own queue. unknown: the queues could not be worked out.

defaultunknown
queuesarray of objectsRequired

At most 50 queues, largest first.

Fields of each item
delayedintegerRequired

Jobs waiting for their time.

listenedboolean or nullRequired

Whether a worker listens on the queue. Null when that is not known.

namestringRequired
name_supportedbooleanRequired

Whether a worker's queue list can name the queue: letters, digits, ., _, : and -, 1 to 64 characters.

oldest_ready_atstring or nullRequired

When the oldest ready job became ready. The database driver only, else null. Format: date-time.

readyintegerRequired

Jobs waiting for a worker now.

reservedintegerRequired

Jobs being worked.

unworkedbooleanRequired

True when the queue has jobs ready and no worker listens on it.

waiting_secondsinteger or nullRequired

How long the oldest ready job has waited. The database driver only, else null.

reasonstring or nullRequired

Why state is unsupported: driver, database_driver, table_name or redis_connection. Null otherwise.

statestringRequired

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_table
truncatedbooleanRequired

True when the site has more queues than are listed.

unreadable_namesintegerRequired

Queues left out because their name has control characters or is longer than 255 bytes.

unworkedarray of stringsRequired

The names of the queues with jobs ready and no worker listening.

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403company_unavailableYour company is unavailable.
403scope_requiredUse a token with the scope named in scope.
403two_factor_requiredTurn on two-factor on your account, then send again.
404feature_offThis feature is not on for your organisation yet.
404wrong_platformThis is not available for the site's platform. Use it on a site of the platform it is for.
409busyAnother operation is running on the site. Wait for it to finish.
409command_runningAnother action or command is still running on the site. Wait for it to finish, then try again.
409deployment_runningA deployment of the environment is running, or a stopped one is still being cleaned up. Wait for it to finish, then try again.
409exec_unresolvedAn earlier command on the site has not been confirmed stopped. Contact support.
409install_runningAn installer is still running on the site. Contact support.
409not_runningThe 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.
409removedThe site or environment is being removed, or has been. Nothing can be changed on it.
409restore_runningA restore is running on the site. Wait for it to finish, then try again.
409site_unadoptedThis site is not ready to be changed from the Control Panel yet. Contact support.
429rate_limitedWait for the seconds in Retry-After.
502helper_failedThe site's database did not answer, so its queues could not be read. Try again in a moment.
503connect_failedThe cluster could not be reached.
503temporarily_unavailableThe Control Panel could not answer just now. Nothing was started; try again shortly.
503switched_offCorefinity 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"
{
  "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"
  ]
}
Try it

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.

Was this helpful?
Open in ClaudeOpen in ChatGPT