{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/twexapi-io/json-schema/twexapi-io-get-followers-response-schema.json",
  "title": "GetFollowersResponse",
  "description": "get followers API response",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/twexapi-io-followers-following-endpoints-api-openapi.yml#/components/schemas/GetFollowersResponse",
  "properties": {
    "code": {
      "type": "integer",
      "title": "Code",
      "description": "HTTP status code",
      "default": 200
    },
    "msg": {
      "type": "string",
      "title": "Msg",
      "description": "Response message",
      "default": "success"
    },
    "data": {
      "anyOf": [
        {
          "items": {
            "anyOf": [
              {
                "$ref": "#/$defs/UserInfo"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": "array"
        },
        {
          "$ref": "#/$defs/FriendshipTaskData"
        }
      ],
      "title": "Data",
      "description": "List of user info, or task handle when count exceeds async threshold"
    }
  },
  "type": "object",
  "required": [
    "data"
  ],
  "$defs": {
    "FriendshipTaskData": {
      "properties": {
        "task_id": {
          "type": "string",
          "title": "Task Id",
          "description": "Task ID for polling status/next endpoints"
        },
        "reused": {
          "type": "boolean",
          "title": "Reused",
          "description": "True if an in-flight task was reused"
        }
      },
      "type": "object",
      "required": [
        "task_id",
        "reused"
      ],
      "title": "FriendshipTaskData",
      "description": "Async friendship fetch task handle"
    },
    "UserInfo": {
      "properties": {
        "userId": {
          "type": "string",
          "title": "Userid",
          "description": "User ID"
        },
        "isBlueVerified": {
          "type": "boolean",
          "title": "Isblueverified",
          "description": "Blue verification status"
        },
        "createdAt": {
          "type": "string",
          "title": "Createdat",
          "description": "Account creation date"
        },
        "createdAtDatetime": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Createdatdatetime",
          "description": "Account creation datetime in ISO format"
        },
        "defaultProfile": {
          "type": "boolean",
          "title": "Defaultprofile",
          "description": "Default profile flag"
        },
        "defaultProfileImage": {
          "type": "boolean",
          "title": "Defaultprofileimage",
          "description": "Default profile image flag"
        },
        "description": {
          "type": "string",
          "title": "Description",
          "description": "Bio description"
        },
        "location": {
          "type": "string",
          "title": "Location",
          "description": "Location"
        },
        "fastFollowersCount": {
          "type": "integer",
          "title": "Fastfollowerscount",
          "description": "Fast followers count"
        },
        "favouritesCount": {
          "type": "integer",
          "title": "Favouritescount",
          "description": "Likes count"
        },
        "followersCount": {
          "type": "integer",
          "title": "Followerscount",
          "description": "Followers count"
        },
        "followingCount": {
          "type": "integer",
          "title": "Followingcount",
          "description": "Following count"
        },
        "hasCustomTimelines": {
          "type": "boolean",
          "title": "Hascustomtimelines",
          "description": "Has custom timelines flag"
        },
        "isTranslator": {
          "type": "boolean",
          "title": "Istranslator",
          "description": "Is translator flag"
        },
        "listedCount": {
          "type": "integer",
          "title": "Listedcount",
          "description": "Listed count"
        },
        "mediaCount": {
          "type": "integer",
          "title": "Mediacount",
          "description": "Media count"
        },
        "name": {
          "type": "string",
          "title": "Name",
          "description": "Display name"
        },
        "normalFollowersCount": {
          "type": "integer",
          "title": "Normalfollowerscount",
          "description": "Normal followers count"
        },
        "pinnedTweetIdsStr": {
          "anyOf": [
            {
              "items": {},
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Pinnedtweetidsstr",
          "description": "Pinned tweet IDs"
        },
        "possiblySensitive": {
          "type": "boolean",
          "title": "Possiblysensitive",
          "description": "Possibly sensitive flag"
        },
        "profileImageUrlHttps": {
          "type": "string",
          "title": "Profileimageurlhttps",
          "description": "Profile image URL"
        },
        "username": {
          "type": "string",
          "title": "Username",
          "description": "Username"
        },
        "statusesCount": {
          "type": "integer",
          "title": "Statusescount",
          "description": "Tweets count"
        },
        "translatorType": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Translatortype",
          "description": "Translator type"
        },
        "verified": {
          "type": "boolean",
          "title": "Verified",
          "description": "Legacy verification status"
        },
        "verified_type": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Verified Type",
          "description": "Verification badge type: blue, business, government, etc."
        },
        "withheldInCountries": {
          "anyOf": [
            {
              "items": {},
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Withheldincountries",
          "description": "Withheld in countries"
        },
        "protected": {
          "type": "boolean",
          "title": "Protected",
          "description": "Protected account flag"
        },
        "url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Url",
          "description": "User profile URL"
        },
        "descriptionUrls": {
          "anyOf": [
            {
              "items": {},
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Descriptionurls",
          "description": "Description URLs"
        },
        "urls": {
          "anyOf": [
            {
              "items": {},
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Urls",
          "description": "User URLs"
        },
        "pinnedTweetIds": {
          "anyOf": [
            {
              "items": {},
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Pinnedtweetids",
          "description": "Pinned tweet IDs"
        }
      },
      "type": "object",
      "required": [
        "userId",
        "isBlueVerified",
        "createdAt",
        "defaultProfile",
        "defaultProfileImage",
        "description",
        "location",
        "fastFollowersCount",
        "favouritesCount",
        "followersCount",
        "followingCount",
        "hasCustomTimelines",
        "isTranslator",
        "listedCount",
        "mediaCount",
        "name",
        "normalFollowersCount",
        "possiblySensitive",
        "profileImageUrlHttps",
        "username",
        "statusesCount",
        "verified",
        "protected"
      ],
      "title": "UserInfo",
      "description": "User information structure"
    }
  }
}