List connections

Retrieves a user’s connections.
OAuth scopes: read_connections

Parameters

user_id String
Optional
The user for which to retrieve connections. Defaults to the current user.
status String
Optional
Filter connections by status. Valid options:

  • active (default): The user’s current connections. User can be the requester or requestee.
  • pending: Connections requested by the user but not approved yet by the requestee.
  • blocked: Connection requests blocked by the user.
per_page Integer
Optional
The maximum number of connections to return. Defaults to 20.
page Integer
Optional
The page number to return. See pagination.

Example Request
GET /connections?status=active&per_page=2
Example Response
200 OK
[
{
"id": "10-11",
"url": "https://api.edmodo.com/connections/10-11",
"status": "active",
"user1": {
"id": 10,
"url": "https://api.edmodo.com/users/10",
"name": "Edna Krabappel",
"type": "teacher",
},
"user2": {
"id": 11,
"url": "https://api.edmodo.com/users/11",
"name: "Seymour Skinner",
"type": "teacher",
}
}
]

Get a single connection

GET /connections/:connection_id

A connection can be retrieved by the requester or requestee.
OAuth scopes: all or read_connections

Example Request
GET /connections/10-11
Example Response
{
"id": "10-11",
"url": "https://api.edmodo.com/connections/10-11",
"status": "active",
"user1": {
"id": 10,
"url": "https://api.edmodo.com/users/10",
"name": "Edna Krabappel",
"type": "teacher",
},
"user2": {
"id": 11,
"url": "https://api.edmodo.com/users/11",
"name: "Seymour Skinner",
"type": "teacher",
}
}