Retrieve a moderation

GET/v1/moderations/{id}Key scope read

Returns one moderation by id, as it was returned when it finished, with its current status. For a form, fields holds one moderation per content field; a field moderation can also be fetched by its own id and then carries parent_id. After the retention period the evidence in details and the metadata are removed, and the scores and the decision remain.

Needs a key with the read scope. Authentication

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

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

const data = await response.json();

import os
import requests

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

data = response.json()

200 OKResponse

{
  "id": "mod_6VxhYOfKENOfbvewPYHrLG",
  "rule": null,
  "test": true,
  "type": "form",
  "usage": {
    "cached": false,
    "checks": 0
  },
  "author": {
    "id": "aut_73LfoUxtEhTnQTwxpx3jEE",
    "known": true,
    "status": "enabled",
    "external_id": "user_3044",
    "trust_level": "new"
  },
  "fields": {
    "title": {
      "id": "mod_1pkg3hfRcAZQeA2ODrLLpG",
      "rule": null,
      "test": true,
      "type": "text",
      "field": "title",
      "usage": {
        "cached": false,
        "checks": 0
      },
      "author": {
        "id": "aut_73LfoUxtEhTnQTwxpx3jEE",
        "known": true,
        "status": "enabled",
        "external_id": "user_3044",
        "trust_level": "new"
      },
      "object": "moderation",
      "status": "completed",
      "details": {
        "spam": {
          "field": "title"
        },
        "sexual": {
          "field": "title"
        },
        "illicit": {
          "field": "title"
        },
        "toxicity": {
          "field": "title"
        },
        "violence": {
          "field": "title"
        },
        "gibberish": {
          "field": "title"
        },
        "profanity": {
          "field": "title"
        },
        "self_harm": {
          "field": "title"
        },
        "hate_speech": {
          "field": "title"
        },
        "made_with_ai": {
          "field": "title"
        },
        "links_contact": {
          "field": "title"
        },
        "personal_data": {
          "field": "title"
        },
        "lookalike_characters": {
          "field": "title"
        },
        "wordlist/competitors": {
          "field": "title",
          "labels": ["block"]
        }
      },
      "dry_run": false,
      "flagged": false,
      "reasons": ["triage:allow"],
      "language": "en",
      "metadata": null,
      "policies": {
        "spam": 0,
        "sexual": 0,
        "illicit": 0,
        "toxicity": 0,
        "violence": 0,
        "gibberish": 0,
        "profanity": 0,
        "self_harm": 0,
        "hate_speech": 0,
        "made_with_ai": 0,
        "links_contact": 0,
        "personal_data": 0,
        "lookalike_characters": 0,
        "wordlist/competitors": 0
      },
      "severity": "none",
      "template": {
        "slug": "listing",
        "version": 2
      },
      "parent_id": "mod_6VxhYOfKENOfbvewPYHrLG",
      "triggered": [],
      "content_id": "listing_20871",
      "context_id": null,
      "created_at": "2026-10-08T09:28:53.647Z",
      "latency_ms": 2524,
      "completed_at": "2026-10-08T09:28:56.957Z",
      "recommendation": "allow"
    },
    "description": {
      "id": "mod_0KBeOEMxRU16O7WjiRLWIY",
      "rule": null,
      "test": true,
      "type": "text",
      "field": "description",
      "usage": {
        "cached": false,
        "checks": 0
      },
      "author": {
        "id": "aut_73LfoUxtEhTnQTwxpx3jEE",
        "known": true,
        "status": "enabled",
        "external_id": "user_3044",
        "trust_level": "new"
      },
      "object": "moderation",
      "status": "completed",
      "details": {
        "spam": {
          "field": "description"
        },
        "sexual": {
          "field": "description"
        },
        "illicit": {
          "field": "description"
        },
        "toxicity": {
          "field": "description"
        },
        "violence": {
          "field": "description"
        },
        "duplicate": {
          "field": "description"
        },
        "gibberish": {
          "field": "description"
        },
        "profanity": {
          "field": "description"
        },
        "self_harm": {
          "field": "description"
        },
        "hate_speech": {
          "field": "description"
        },
        "made_with_ai": {
          "field": "description"
        },
        "links_contact": {
          "field": "description"
        },
        "personal_data": {
          "field": "description"
        },
        "lookalike_characters": {
          "field": "description"
        },
        "wordlist/competitors": {
          "field": "description",
          "labels": ["block"]
        }
      },
      "dry_run": false,
      "flagged": false,
      "reasons": ["triage:allow"],
      "language": "en",
      "metadata": null,
      "policies": {
        "spam": 0,
        "sexual": 0,
        "illicit": 0,
        "toxicity": 0,
        "violence": 0,
        "duplicate": 0,
        "gibberish": 0,
        "profanity": 0,
        "self_harm": 0,
        "hate_speech": 0,
        "made_with_ai": 0.1,
        "links_contact": 0,
        "personal_data": 0,
        "lookalike_characters": 0,
        "wordlist/competitors": 0
      },
      "severity": "low",
      "template": {
        "slug": "listing",
        "version": 2
      },
      "parent_id": "mod_6VxhYOfKENOfbvewPYHrLG",
      "triggered": [],
      "content_id": "listing_20871",
      "context_id": null,
      "created_at": "2026-10-08T09:28:53.734Z",
      "latency_ms": 2524,
      "completed_at": "2026-10-08T09:28:56.957Z",
      "recommendation": "allow"
    }
  },
  "object": "moderation",
  "status": "completed",
  "details": {
    "instructions": {
      "labels": ["confidence:100"],
      "explanation": "The title, description, and price appear to be consistent and describe a plausible offer."
    },
    "guideline/no-off-site-deals": {
      "field": "description",
      "labels": ["confidence:100"],
      "matches": [
        {
          "field": "description",
          "label": "evidence",
          "value": "Collection in person or tracked delivery."
        }
      ],
      "explanation": "The listing mentions collection in person or tracked delivery, which are standard options and do not suggest off-site payment or arrangement."
    }
  },
  "dry_run": false,
  "flagged": false,
  "reasons": ["triage:allow"],
  "language": "en",
  "metadata": null,
  "policies": {
    "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,
    "made_with_ai": 0.1,
    "image_quality": 0,
    "links_contact": 0,
    "personal_data": 0,
    "lookalike_characters": 0,
    "wordlist/competitors": 0,
    "guideline/no-off-site-deals": 0
  },
  "severity": "low",
  "template": {
    "slug": "listing",
    "version": 2
  },
  "triggered": [],
  "content_id": "listing_20871",
  "context_id": null,
  "created_at": "2026-10-08T09:28:53.553Z",
  "latency_ms": 2524,
  "completed_at": "2026-10-08T09:28:56.957Z",
  "recommendation": "allow"
}

Path parameters

idstringRequired: Id of the moderation: mod_ plus 22 base62 characters.

Returns

The moderation.

200 OKA moderation object

Errors

404: not_found
The key's project has no moderation with this id, or the id is malformed.

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.