Get a Reddit profile

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://docs.usehearsay.com/mcp

Standard setup for AI tools providing an mcp.json file

{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}

GET /reddit/{caseId}/profile/{redditId}

Access token

Returns one Reddit profile linked to the case; returns 404 if it is archived or not linked. On a case shared with opposing counsel, a profile the caller may not see returns 404.

Path parameters

caseId string Required
redditId string Required

Responses

200 application/json
Hide response attributes Show response attributes object
- data object Required
  
  Hide data attributes Show data attributes object
  
  createdAt string(date-time) Required
  
  updatedAt string(date-time) Required
  
  id string Required
  
  redditUserId string Required
  
  email string | null Required
  
  Not filled by any importer today, so always null.
  
  emailVerified boolean Required
  
  Not filled by any importer today, so always false.
  
  registrationDate string(date-time) | null Required
  
  Not filled by any importer today, so always null.
  
  isDeleted boolean Required
  
  accountGender string | null Required
  
  birthdate string | null Required
  
  linkedIdentities array[object] Required
  
  friends array[object] Required
  
  subscribedSubreddits array[string] Required
  
  gildedContent array[object] Required
  
  multireddits array[object] Required
  
  ipLogs array[object] Required
  
  deletedAt string(date-time) | null Required
  
  deletedBy string | null Required
  
  ocSharedStatus string | null
  
  Opposing-council only: whether this provider has been shared with the OL. null for OL/OG callers — same convention as every other item listing. Provider-level: every item under it shares this status, since approval here is all-or-nothing.
  
  Values are shared, pending, or not_gated.
- statusCode number Required
- timestamp string(date-time) Required

GET /reddit/{caseId}/profile/{redditId}

curl \
 --request GET 'http://api.example.com/reddit/{caseId}/profile/{redditId}' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "data": {
    "createdAt": "2026-01-15T14:30:00.000Z",
    "updatedAt": "2026-01-15T14:30:00.000Z",
    "id": "507f1f77bcf86cd799439011",
    "redditUserId": "jane_doe_42",
    "email": "string",
    "emailVerified": false,
    "registrationDate": "2026-05-04T09:42:00Z",
    "isDeleted": false,
    "accountGender": "female",
    "birthdate": "1990-04-12",
    "linkedIdentities": [
      {
        "issuerId": "https://accounts.google.com",
        "subjectId": "104857600123456789012"
      }
    ],
    "friends": [
      {
        "note": "",
        "username": "john_smith_7"
      }
    ],
    "subscribedSubreddits": [
      "AskReddit",
      "personalfinance"
    ],
    "gildedContent": [
      {
        "amount": 1,
        "award": "gold",
        "contentLink": "https://www.reddit.com/r/AskReddit/comments/1abc2de/comment/kx1y2z3/",
        "date": "2026-01-15T14:30:00.000Z"
      }
    ],
    "multireddits": [
      {
        "display_name": "news",
        "id": "m4abc1",
        "subreddits": "worldnews,news"
      }
    ],
    "ipLogs": [
      {
        "date": "2026-01-15 14:30:00 UTC",
        "ip": "203.0.113.7"
      }
    ],
    "deletedAt": "2026-05-04T09:42:00Z",
    "deletedBy": "string",
    "ocSharedStatus": "shared"
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}