List authors

GET/v1/authorsKey scope read

Lists the project's authors with their status, trust level, risk score and counters. Sort by recent activity, trust level, risk score or creation date to find the authors that need attention.

Needs a key with the read scope. Authentication

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

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

const data = await response.json();

import os
import requests

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

data = response.json()

200 OKResponse

{
  "object": "list",
  "data": [
    {
      "object": "author",
      "id": "aut_7ZRftUOZyMjsmFWvJifaOJ",
      "project_id": "prj_0TBAgHGtdMketrbltGFHuk",
      "external_id": "user_4821",
      "display_name": "Maya Okafor",
      "status": "enabled",
      "status_reason": "Appeal accepted",
      "status_until": null,
      "trust_level": "new",
      "trust_level_automatic": "new",
      "trust_override": null,
      "risk_score": 0.9,
      "stats": {
        "moderations": 5,
        "flagged": 5,
        "rejected": 5,
        "reviewed": 0,
        "reports": 0
      },
      "first_seen_at": "2026-10-08T08:50:58.962Z",
      "last_seen_at": "2026-10-08T09:28:46.195Z",
      "metadata": {
        "country": "GB",
        "email_verified": true
      },
      "created_at": "2026-10-08T08:50:59.118Z",
      "updated_at": "2026-10-08T09:28:46.195Z"
    },
    {
      "object": "author",
      "id": "aut_4jb9a0j0nR6JwaRhJm4IWN",
      "project_id": "prj_0TBAgHGtdMketrbltGFHuk",
      "external_id": "user_5290",
      "display_name": null,
      "status": "enabled",
      "status_reason": null,
      "status_until": null,
      "trust_level": "basic",
      "trust_level_automatic": "basic",
      "trust_override": null,
      "risk_score": 0,
      "stats": {
        "moderations": 5,
        "flagged": 0,
        "rejected": 0,
        "reviewed": 0,
        "reports": 0
      },
      "first_seen_at": "2026-10-08T08:51:03.685Z",
      "last_seen_at": "2026-10-08T09:28:41.947Z",
      "metadata": {},
      "created_at": "2026-10-08T08:51:03.844Z",
      "updated_at": "2026-10-08T09:28:41.948Z"
    }
  ],
  "has_more": true,
  "next_cursor": "WyIyMDI2LTEwLTA4VDA5OjI4OjQxLjk0N1oiLCI5Yjk3YmM5NS1hMzIxLTQ3MTQtOTUzMC0zYzUxZWJhOWI3ZGYiXQ"
}

Query parameters

limitintegerDefault 20

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

cursorstring

The next_cursor of the previous page, for a request with the same sort and order. Omit it for the first page.

statusenum

Return only authors in this status: enabled, suspended or blocked.

One ofenabledsuspendedblocked

trust_levelenum

Return only authors whose automatic trust level is this value: new, basic, regular, established or trusted. The filter reads the automatic level, so an author with a trust_override is matched by the level underneath it and not by the trust_level the response shows.

One ofnewbasicregularestablishedtrusted

sortenum

What to sort by: activity (last seen, the default), trust (automatic trust level, from new to trusted), risk (risk score) or created (creation date). With risk, authors without a risk score come last in either order.

One ofactivitytrustriskcreated

orderenum

desc (default) or asc.

One ofascdesc

Returns

A list object: data holds up to limit authors, 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 author objects

Errors

400: invalid_cursor
cursor is not a value returned by this endpoint.
422: validation_error
limit is outside 1 to 100, or status, trust_level, sort or order 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.