Skip to content

List wordlists

GET/v1/wordlistsKey scope read

Lists the project's wordlists, oldest first, without their terms. The list is not paginated.

Needs a key with the read scope. Authentication

curl https://api.useinfrared.com/v1/wordlists \
  -H "Authorization: Bearer $INFRARED_KEY"
200 OKResponse
{
  "object": "list",
  "data": [
    {
      "object": "wordlist",
      "id": "wl_5pLeuA3L3i0NVotCEeX1nk",
      "project_id": "prj_0TBAgHGtdMketrbltGFHuk",
      "slug": "competitors",
      "policy": "wordlist/competitors",
      "name": "Competitors",
      "description": "Other marketplaces that listings should not send buyers to.",
      "mode": "block",
      "match_preset": "same_word",
      "language": null,
      "enabled": true,
      "entries_count": 5,
      "created_at": "2026-10-08T08:44:28.840Z",
      "updated_at": "2026-10-08T08:49:34.839Z"
    },
    {
      "object": "wordlist",
      "id": "wl_5KcJIqikl2tXcuKJHvpzgO",
      "project_id": "prj_0TBAgHGtdMketrbltGFHuk",
      "slug": "restricted-items",
      "policy": "wordlist/restricted-items",
      "name": "Restricted items",
      "description": null,
      "mode": "block",
      "match_preset": "similar",
      "language": null,
      "enabled": true,
      "entries_count": 3,
      "created_at": "2026-10-08T09:29:26.558Z",
      "updated_at": "2026-10-08T09:29:28.088Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Returns

A list object that holds every wordlist. has_more is always false.

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.