List templates

GET/v1/templatesKey scope read

Lists the project's templates: the built-in basic check first, then the others in order of creation. The list is not paginated. A template that was never published has version set to null and no configuration properties.

Needs a key with the read scope. Authentication

curl https://api.useinfrared.com/v1/templates \
  -H "Authorization: Bearer $INFRARED_KEY"

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

const data = await response.json();

import os
import requests

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

data = response.json()

200 OKResponse

{
  "object": "list",
  "data": [
    {
      "object": "template",
      "id": "tpl_7CMEFMWJV8VbLGhdSoRUUB",
      "slug": "basic",
      "name": "Basic check",
      "description": "The built-in check of one text or image for common violations. It runs when a request names no template.",
      "status": "active",
      "built_in": true,
      "version": 1,
      "context": null,
      "fields": [
        {
          "key": "text",
          "name": "Text",
          "type": "text",
          "required": false,
          "triggers": [],
          "validation": {}
        },
        {
          "key": "image",
          "name": "Image",
          "type": "image",
          "required": false,
          "triggers": [],
          "validation": {
            "max_bytes": 10485760,
            "max_items": 10
          }
        }
      ],
      "policies": [
        {
          "key": "toxicity",
          "mode": "trigger"
        },
        {
          "key": "hate_speech",
          "mode": "trigger"
        },
        {
          "key": "profanity",
          "mode": "trigger"
        }
      ],
      "triggers": [],
      "rules": [],
      "severity": {
        "reject": 0.8,
        "review": 0.4
      },
      "ai_instructions": null,
      "settings": {},
      "created_at": "2026-10-08T08:44:19.741Z",
      "updated_at": "2026-10-08T08:44:19.894Z"
    },
    {
      "object": "template",
      "id": "tpl_64mYq4nD3NXNfu0gcdaMZa",
      "slug": "listing",
      "name": "Listing",
      "description": null,
      "status": "active",
      "built_in": false,
      "version": 2,
      "context": "A public listing on a marketplace: an item, a service, a property or a vehicle for sale or rent, with a price and photos of what is offered. Buyers contact the seller through the platform.",
      "fields": [
        {
          "key": "title",
          "name": "Title",
          "type": "text",
          "required": true,
          "triggers": [
            {
              "effect": "flag",
              "policy": "hate_speech"
            },
            {
              "effect": "flag",
              "policy": "links_contact"
            }
          ],
          "validation": {
            "max_length": 120,
            "min_length": 5
          },
          "description": "Short headline naming what is offered."
        },
        {
          "key": "description",
          "name": "Description",
          "type": "text",
          "required": true,
          "triggers": [
            {
              "effect": "flag",
              "policy": "profanity"
            },
            {
              "effect": "flag",
              "policy": "toxicity"
            }
          ],
          "validation": {
            "max_length": 5000
          },
          "description": "What is offered: condition, specifications, terms and details."
        },
        {
          "key": "price",
          "name": "Price",
          "type": "number",
          "required": false,
          "triggers": [],
          "validation": {
            "min": 0
          },
          "description": "The asking price in the listing's currency."
        },
        {
          "key": "photos",
          "name": "Photos",
          "type": "image",
          "required": false,
          "triggers": [
            {
              "effect": "review",
              "policy": "made_with_ai",
              "threshold": 0.9
            }
          ],
          "validation": {
            "max_bytes": 10485760,
            "max_items": 10
          },
          "description": "Photos of what is offered: the item, property, vehicle or premises. Logos, labels and signage with the seller's own details are normal."
        }
      ],
      "policies": [
        {
          "key": "profanity",
          "mode": "trigger"
        },
        {
          "key": "hate_speech",
          "mode": "trigger"
        },
        {
          "key": "toxicity",
          "mode": "trigger"
        }
      ],
      "triggers": [
        {
          "effect": "flag",
          "policy": "hate_speech"
        },
        {
          "effect": "flag",
          "policy": "toxicity"
        },
        {
          "effect": "flag",
          "policy": "violence"
        }
      ],
      "rules": [
        {
          "id": "r1",
          "name": "Block banned authors",
          "action": "reject",
          "enabled": true,
          "conditions": [
            {
              "op": "is_not",
              "type": "author_status",
              "value": "enabled"
            }
          ]
        },
        {
          "id": "r2",
          "name": "Zero tolerance for hate",
          "action": "reject",
          "enabled": true,
          "conditions": [
            {
              "type": "policy_flagged",
              "value": true,
              "policy": "hate_speech"
            }
          ]
        },
        {
          "id": "r3",
          "name": "Illicit goods",
          "action": "reject",
          "enabled": true,
          "conditions": [
            {
              "type": "policy_flagged",
              "value": true,
              "policy": "illicit"
            }
          ]
        }
      ],
      "severity": {
        "reject": 0.8,
        "review": 0.4
      },
      "ai_instructions": "Check that the title, description, price and photos describe the same offer, that the photos show what is offered rather than unrelated or stock images, and that the price is plausible for what is described. Flag listings that only advertise another website or ask buyers to pay outside the platform.",
      "settings": {},
      "created_at": "2026-10-08T08:44:31.624Z",
      "updated_at": "2026-10-08T09:28:01.454Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Query parameters

status: Return only templates in this status: draft, active or archived. Without it, every template that is not archived is returned.

Returns

A list object that holds every matching template. has_more is always false.

200 OKA list of template objects

Errors

422: validation_error
status is not draft, active or archived.

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.