Retrieve an author

GET/v1/authors/{external_id}Key scope read

Returns one author by your own id for that user.

Needs a key with the read scope. Authentication

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

const response = await fetch("https://api.useinfrared.com/v1/authors/user_4821", {
  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/user_4821",
    headers={"Authorization": f"Bearer {os.environ['INFRARED_KEY']}"},
)

data = response.json()

200 OKResponse

{
  "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"
}

Path parameters

external_idstringRequired: Your id for the end user, as sent in author_id. URL-encode it when it contains reserved characters.

Returns

The author.

200 OKAn author object

Errors

404: not_found
The project has no author with this id.

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.