Use this method to get a list of profile pictures for a user

POST /getUserProfilePhotos

Use this method to get a list of profile pictures for a user. Returns a UserProfilePhotos object.

Body Required

  • user_id integer Required

    Unique identifier of the target user

  • offset integer

    Sequential number of the first photo to be returned. By default, all photos are returned.

  • limit integer

    Limits the number of photos to be retrieved. Values between 1-100 are accepted. Defaults to 100.

    Minimum value is 1, maximum value is 100. Default value is 100.

Responses

  • 200
    Hide response attributes Show response attributes object
    • ok boolean Required

      Default value is true.

    • result object Required

      This object represent a user's profile pictures.

      Hide result attributes Show result attributes object
      • total_count integer Required

        Total number of profile pictures the target user has

      • Requested profile pictures (in up to 4 sizes each)

  • default
    Hide response attributes Show response attributes object
    • ok boolean Required

      Default value is false.

    • error_code integer Required
    • description string Required
    • parameters object

      Contains information about why a request was unsuccessful.

      Hide parameters attributes Show parameters attributes object
      • migrate_to_chat_id integer

        Optional. The group has been migrated to a supergroup with the specified identifier. This number may be greater than 32 bits and some programming languages may have difficulty/silent defects in interpreting it. But it is smaller than 52 bits, so a signed 64 bit integer or double-precision float type are safe for storing this identifier.

      • retry_after integer

        Optional. In case of exceeding flood control, the number of seconds left to wait before the request can be repeated

POST /getUserProfilePhotos
curl \
 -X POST https://api.telegram.org/bot123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11/getUserProfilePhotos \
 -H "Content-Type: application/json" \
 -d '{"user_id":42,"offset":42,"limit":100}'
Request example
{
  "user_id": 42,
  "offset": 42,
  "limit": 100
}
Request examples
{
  "user_id": 42,
  "offset": 42,
  "limit": 100
}
Response examples (200)
{
  "ok": true,
  "result": {
    "total_count": 42,
    "": [
      [
        {}
      ]
    ]
  }
}
Response examples (200)
{
  "ok": true,
  "result": {
    "total_count": 42,
    "": [
      [
        {}
      ]
    ]
  }
}
Response examples (default)
{
  "ok": false,
  "error_code": 42,
  "description": "string",
  "parameters": {
    "migrate_to_chat_id": 42,
    "retry_after": 42
  }
}
Response examples (default)
{
  "ok": false,
  "error_code": 42,
  "description": "string",
  "parameters": {
    "migrate_to_chat_id": 42,
    "retry_after": 42
  }
}