GET
/
authors
/
{id}
Get author details
curl --request GET \
  --url https://moderationapi.com/api/v1/authors/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "external_id": "<string>",
  "profile_picture": "<string>",
  "external_link": "<string>",
  "name": "<string>",
  "email": "jsmith@example.com",
  "first_seen": 123,
  "last_seen": 123,
  "last_incident": 123,
  "status": "enabled",
  "trust_level": {
    "level": 123,
    "manual": true
  },
  "block": {
    "until": 123,
    "reason": "<string>"
  },
  "risk_evaluation": {
    "risk_level": 50
  },
  "metrics": {
    "total_content": 123,
    "flagged_content": 123,
    "average_sentiment": 123
  },
  "metadata": {
    "email_verified": true,
    "phone_verified": true,
    "identity_verified": true,
    "is_paying_customer": true
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Either external ID or the ID assigned by moderation API.

Response

Successful response

id
string
required

Author ID in Moderation API

first_seen
number
required

Timestamp when author first appeared

last_seen
number
required

Timestamp of last activity

status
enum<string>
required

Current author status

Available options:
enabled,
suspended,
blocked
trust_level
object
required
block
object | null
required

Block or suspension details, if applicable. Null if the author is enabled.

risk_evaluation
object | null
required

Risk assessment details, if available.

metrics
object
required
metadata
object
required

Additional metadata provided by your system. We recommend including any relevant information that may assist in the moderation process.

external_id
string | null

The author's ID from your system

profile_picture
string<uri> | null

URL of the author's profile picture

URL of the author's external profile

name
string | null

Author name or identifier

email
string<email> | null

Author email address

last_incident
number | null

Timestamp of last incident