List queue items

GET/v1/queueKey scope read

Lists review queue items, oldest first by default. Without state, only open items are returned: those in the states pending and reopened.

Needs a key with the read scope. Authentication

curl "https://api.useinfrared.com/v1/queue?limit=2&sort=desc" \
  -H "Authorization: Bearer $INFRARED_KEY"

const response = await fetch("https://api.useinfrared.com/v1/queue?limit=2&sort=desc", {
  headers: { Authorization: `Bearer ${process.env.INFRARED_KEY}` },
});

const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.useinfrared.com/v1/queue",
    headers={"Authorization": f"Bearer {os.environ['INFRARED_KEY']}"},
    params={
        "limit": 2,
        "sort": "desc",
    },
)

data = response.json()

200 OKResponse

{
  "object": "list",
  "data": [
    {
      "object": "queue_item",
      "id": "qi_6Dv2KCo2s8S8vJqQF6jPm1",
      "project_id": "prj_0TBAgHGtdMketrbltGFHuk",
      "moderation_id": "mod_5d9DTbKQOev1NmVKGQFFDN",
      "template_id": "tpl_64mYq4nD3NXNfu0gcdaMZa",
      "author_id": "aut_4fTalaDkUNUCejyFiOHa1E",
      "state": "pending",
      "priority": "high",
      "severity": "high",
      "language": "en",
      "reason": "rule",
      "conflict": false,
      "resolution": null,
      "assignee": null,
      "assigned_at": null,
      "sla_due_at": null,
      "resolved_by": null,
      "resolved_at": null,
      "reopened_at": null,
      "settled_by_case_id": null,
      "summary": {
        "type": "text",
        "author": {
          "id": "aut_4fTalaDkUNUCejyFiOHa1E",
          "status": "enabled",
          "external_id": "user_2718",
          "trust_level": "new"
        },
        "scores": {
          "spam": 0,
          "sexual": 0,
          "illicit": 0,
          "toxicity": 0,
          "violence": 0,
          "duplicate": 0,
          "gibberish": 0,
          "profanity": 0,
          "self_harm": 0,
          "watermark": 0,
          "screenshot": 0,
          "hate_speech": 0,
          "instructions": 0.8,
          "made_with_ai": 0,
          "image_quality": 0,
          "links_contact": 0.9,
          "personal_data": 0.75,
          "lookalike_characters": 0,
          "wordlist/competitors": 0,
          "guideline/no-off-site-deals": 0.8
        },
        "dry_run": false,
        "preview": "Grey corner sofa bed, email sofa.seller@example.com",
        "language": "en",
        "severity": "high",
        "template": "listing",
        "triggered": [
          "links_contact",
          "personal_data",
          "guideline/no-off-site-deals",
          "instructions"
        ],
        "content_id": "listing_20873"
      },
      "created_at": "2026-10-08T09:29:09.449Z",
      "updated_at": "2026-10-08T09:29:09.449Z"
    },
    {
      "object": "queue_item",
      "id": "qi_3mr0Fb23lDSkWuE29vDfTH",
      "project_id": "prj_0TBAgHGtdMketrbltGFHuk",
      "moderation_id": "mod_63ajou7C7QWp0VYZDPRRvY",
      "template_id": "tpl_64mYq4nD3NXNfu0gcdaMZa",
      "author_id": "aut_09rs1aKw1Rzu53E2C4ER7u",
      "state": "pending",
      "priority": "urgent",
      "severity": "critical",
      "language": "en",
      "reason": "rule",
      "conflict": false,
      "resolution": null,
      "assignee": null,
      "assigned_at": null,
      "sla_due_at": null,
      "resolved_by": null,
      "resolved_at": null,
      "reopened_at": null,
      "settled_by_case_id": null,
      "summary": {
        "type": "text",
        "author": {
          "id": "aut_09rs1aKw1Rzu53E2C4ER7u",
          "status": "enabled",
          "external_id": "user_1307",
          "trust_level": "new"
        },
        "scores": {
          "spam": 0,
          "sexual": 0,
          "illicit": 0.0038,
          "toxicity": 0,
          "violence": 0,
          "duplicate": 0,
          "gibberish": 0,
          "profanity": 0,
          "self_harm": 0,
          "watermark": 0,
          "screenshot": 0,
          "hate_speech": 0,
          "instructions": 0.8,
          "made_with_ai": 0,
          "image_quality": 0,
          "links_contact": 0.8,
          "personal_data": 0.75,
          "lookalike_characters": 0,
          "wordlist/competitors": 0.85,
          "guideline/no-off-site-deals": 1
        },
        "dry_run": false,
        "preview": "Road bike, 54 cm frame, serviced last month. I also list on Tradely. Text me on +44 7700 900142 and pay by bank transfer to skip the fees.",
        "language": "en",
        "severity": "critical",
        "template": "listing",
        "triggered": [
          "personal_data",
          "guideline/no-off-site-deals",
          "wordlist/competitors",
          "instructions"
        ],
        "content_id": "listing_20872"
      },
      "created_at": "2026-10-08T09:29:03.917Z",
      "updated_at": "2026-10-08T09:29:03.917Z"
    }
  ],
  "has_more": true,
  "next_cursor": "WyIyMDI2LTEwLTA4VDA5OjI5OjAzLjkxN1oiLCI3Yzc2MTA3Mi02ZDExLTQzYzctODBhMS02NGEzZTQwYzVkNDMiXQ"
}

Query parameters

limitintegerDefault 20

Number of items to return, 1 to 100. Default 20.

cursorstring

The next_cursor of the previous page. Omit it for the first page.

stateenum

Return only items in this state: pending, resolved or reopened. Default: pending and reopened together.

One ofpendingresolvedreopened

templatestring

Return only items whose moderation ran on the template with this slug.

languagestring

Return only items whose content is in this language, as an ISO 639-1 code such as en.

severitystring

Return only items with this severity: none, low, medium, high or critical. Several values can be sent separated by commas. A value outside the list matches nothing.

prioritystring

Return only items with this priority: low, normal, high or urgent. Several values can be sent separated by commas. A value outside the list answers 500 internal_error, not 422.

sortenum

Order by creation date: asc (oldest first, the default) or desc.

One ofascdesc

Returns

A list object: data holds up to limit queue items, has_more says whether another page exists and next_cursor is the value to send as cursor, or null on the last page.

200 OKA list of queue item objects

Errors

400: invalid_cursor
cursor is not a value returned by this endpoint.
422: validation_error
limit is outside 1 to 100, or state or sort is not one of the listed values.

Every endpoint can also answer the errors any request can meet: a missing key, a rate limit, a malformed body. Errors

Something missing or unclear on this page? Write to support@useinfrared.com.