> ## Documentation Index > Fetch the complete documentation index at: https://docs.twitterapi.io/llms.txt > Use this file to discover all available pages before exploring further. # Get User Subscriptions > Get the creators a user subscribes to (the accounts they pay to support with X Creator Subscriptions, shown on the "Subscriptions" tab of their profile). This is not the list of people who subscribe to the user. - Pass the numeric user ID (`userId`). To get the ID from a username, call [Get User Info](/api-reference/endpoint/get_user_by_username) first. - Up to 20 creators per page. Use `next_cursor` for the next page; `has_next_page` is `false` on the last page. - Most accounts don't subscribe to anyone, so an empty `users` list with `status: "success"` is normal. - If the user doesn't exist or is suspended, the response is `status: "error"` with `msg: "user not found"`. - Price: 15 credits per creator returned, with a minimum of 15 credits per request. - Empty results (the user subscribes to nobody) and "user not found" responses are charged the 15-credit minimum. - If our upstream is temporarily unavailable, the request returns HTTP 502 and is not charged; retry later. - For protected accounts, results reflect what the account shows publicly. ## OpenAPI ````yaml GET /twitter/user/subscriptions openapi: 3.0.1 info: title: TwitterAPI.io the most stable/fastest/cheapest twitter api. description: Provide the most stable/fastest/cheapest twitter api. license: name: MIT version: 1.0.0 servers: - url: https://api.twitterapi.io security: - ApiKeyAuth: [] paths: /twitter/user/subscriptions: get: summary: Get User Subscriptions description: >- Get the creators a user subscribes to (the accounts they pay to support with X Creator Subscriptions, shown on the "Subscriptions" tab of their profile). This is not the list of people who subscribe to the user. - Pass the numeric user ID (`userId`). To get the ID from a username, call [Get User Info](/api-reference/endpoint/get_user_by_username) first. - Up to 20 creators per page. Use `next_cursor` for the next page; `has_next_page` is `false` on the last page. - Most accounts don't subscribe to anyone, so an empty `users` list with `status: "success"` is normal. - If the user doesn't exist or is suspended, the response is `status: "error"` with `msg: "user not found"`. - Price: 15 credits per creator returned, with a minimum of 15 credits per request. - Empty results (the user subscribes to nobody) and "user not found" responses are charged the 15-credit minimum. - If our upstream is temporarily unavailable, the request returns HTTP 502 and is not charged; retry later. - For protected accounts, results reflect what the account shows publicly. parameters: - name: userId in: query required: true description: Numeric user ID, e.g. 11768582. Usernames are not accepted. schema: type: string - name: cursor in: query required: false description: >- Cursor from the previous response's next_cursor. Omit or leave empty for the first page. schema: type: string responses: '200': description: Creators the user subscribes to content: application/json: schema: type: object properties: users: type: array items: $ref: '#/components/schemas/UserInfo' description: Creators the user subscribes to (up to 20 per page) has_next_page: type: boolean description: true if another page exists; false on the last page next_cursor: type: string nullable: true description: Cursor for the next page (null on the last page) status: type: string enum: - success - error description: success, or error when the user doesn't exist msg: type: string description: Error message, e.g. "user not found" '400': description: Invalid userId or cursor content: application/json: schema: $ref: '#/components/schemas/Error' '502': description: Temporarily unavailable, not charged. Please retry. content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: UserInfo: type: object properties: type: type: string enum: - user userName: type: string description: The username of the Twitter user url: type: string description: The x.com URL of the user's profile id: type: string description: The unique identifier of the user name: type: string description: The display name of the user isBlueVerified: type: boolean description: Whether the user has Twitter Blue verification protected: type: boolean description: >- Whether the account is private (protected). Only approved followers can see its posts verifiedType: type: string description: The type of verification. eg. "government" ,can be empty profilePicture: type: string description: URL of the user's profile picture coverPicture: type: string description: URL of the user's cover picture description: type: string description: The user's profile description location: type: string description: 'The user''s location.for example: 東京の端っこ . may be empty' followers: type: integer description: Number of followers following: type: integer description: Number of accounts following canDm: type: boolean description: Whether the user can receive DMs createdAt: type: string description: >- When the account was created. Format depends on the endpoint: /twitter/user/info returns ISO 8601 (e.g. 2007-12-19T20:20:32.000000Z); inside tweet objects (tweet.author) it is the classic X format (e.g. Wed Dec 19 20:20:32 +0000 2007). favouritesCount: type: integer description: Number of favorites hasCustomTimelines: type: boolean description: Whether the user has custom timelines isTranslator: type: boolean description: Whether the user is a translator mediaCount: type: integer description: Number of media posts statusesCount: type: integer description: Number of status updates withheldInCountries: type: array items: type: string description: Countries where the account is withheld affiliatesHighlightedLabel: type: object possiblySensitive: type: boolean description: Whether the account may contain sensitive content pinnedTweetIds: type: array items: type: string description: IDs of pinned tweets isAutomated: type: boolean description: Whether the account is automated automatedBy: type: string description: The account that automated the account unavailable: type: boolean description: Whether the account is unavailable message: type: string description: >- The message of the account.eg. "This account is unavailable" or "This account is suspended" unavailableReason: type: string description: 'The reason the account is unavailable.eg. "suspended" ' profile_bio: type: object properties: description: type: string entities: type: object properties: description: type: object properties: urls: type: array items: type: object properties: display_url: type: string expanded_url: type: string indices: type: array items: type: integer url: type: string url: type: object properties: urls: type: array items: type: object properties: display_url: type: string expanded_url: type: string indices: type: array items: type: integer url: type: string Error: required: - error - message type: object properties: error: type: integer format: int32 message: type: string securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.