Skip to Content

Guides

Authentication House rules App checklist SDKs and tools Our apps

API

Approve a request POST Count requests received GET Deny a request POST Get a friend's folder GET List friends GET List requests received GET List requests sent GET Remove a friend POST Send a request POST

Register an app GitHub put.io

API/Friends/List friends

Register an app

List friends

GEThttps://api.put.io/v2/friends/list

Returns

200

friendsarray

totalinteger

statusstring

Errors

JSON with error_type, error_message, error_id and extra.

429Too many requests. Limits are per token and per IP. Wait until X-RateLimit-Reset, then retry.

cURL

curl https://api.put.io/v2/friends/list \
  -H "Authorization: Bearer $TOKEN"

Response · 200

{
  "friends": [
    {
      "name": "string",
      "avatar_url": "http://example.com",
      "id": 0,
      "has_shared_files": true,
      "has_received_files": true
    }
  ],
  "total": 0,
  "status": "OK"
}

Shape from the spec. Values are placeholders.

The chat didn't load

Something in your browser may be blocking it. Email us at support@put.io instead.