> For the complete documentation index, see [llms.txt](https://docs.moocit.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.moocit.fr/english/api/grades.md).

# Grades

### Get all grades

## List all grades

<mark style="color:blue;">`GET`</mark> `https://your-platform-url.com/api/so2/v1/grades`

Get all course user grades for your instance

#### Headers

| Name                                                             | Type   | Description           |
| ---------------------------------------------------------------- | ------ | --------------------- |
| Access-Control-Request-Headers<mark style="color:red;">\*</mark> | string | authorization         |
| Authorization<mark style="color:red;">\*</mark>                  | string | Bearer \<auth\_token> |
| Content-Type<mark style="color:red;">\*</mark>                   | string | application/json      |

{% tabs %}
{% tab title="200 " %}
{% code overflow="wrap" %}

```json
{"username":"johndoe",
"email":"john@example.com",
"course_id":"course-v1:MOOCit-demo-1",
"display_name": "MOOCit demonstration Course #1",
"percent_grade":"0.80",
"letter_grade":"Pass",
"passed_timestamp":"2020-03-28 23:21:24.354019"
"last_date":"2020-11-26"
}, 
{"username":"JaneDoe",
"email":"jane@example.com",
"course_id":"course-v1:MOOCit-demo-2",
"display_name": "MOOCit demonstration Course #2",
"percent_grade":"0.20",
"letter_grade":"",
"passed_timestamp":null
"last_date":"2020-11-26"
}
...
```

{% endcode %}
{% endtab %}
{% endtabs %}

### Get grades by course

## List grades by course

<mark style="color:blue;">`GET`</mark> `https://your-platform-url.com/api/so2/v1/grades?course_id={course_id}`

Get course user grades for a given course

#### Query Parameters

| Name       | Type   | Description                              |
| ---------- | ------ | ---------------------------------------- |
| course\_id | string | the course\_id course-v1:org+num+session |

#### Headers

| Name                                                             | Type   | Description           |
| ---------------------------------------------------------------- | ------ | --------------------- |
| Access-Control-Request-Headers<mark style="color:red;">\*</mark> | string | authorization         |
| Authorization<mark style="color:red;">\*</mark>                  | string | Bearer \<auth\_token> |
| Content-Type<mark style="color:red;">\*</mark>                   | string | application/json      |

{% tabs %}
{% tab title="200 " %}
{% code overflow="wrap" %}

```json
{"username":"johndoe",
"email":"john@example.com",
"course_id":"course-v1:MOOCit-demo-1",
"display_name": "MOOCit demonstration Course #1",
"percent_grade":"0.80",
"letter_grade":"Pass",
"passed_timestamp":"2020-03-28 23:21:24.354019"
"last_date":"2020-11-26"
}, 
{"username":"JaneDoe",
"email":"jane@example.com",
"course_id":"course-v1:MOOCit-demo-2",
"display_name": "MOOCit demonstration Course #1",
"percent_grade":"0.20",
"letter_grade":"",
"passed_timestamp":null
"last_date":"2020-11-26"
}
...
```

{% endcode %}
{% endtab %}
{% endtabs %}

### Get grades by username

## List grades by username

<mark style="color:blue;">`GET`</mark> `https://your-platform-url.com/api/so2/v1/grades?username={username}`

Get course grades for a given username

#### Query Parameters

| Name     | Type   | Description |
| -------- | ------ | ----------- |
| username | string |             |

#### Headers

| Name                                                             | Type   | Description           |
| ---------------------------------------------------------------- | ------ | --------------------- |
| Access-Control-Request-Headers<mark style="color:red;">\*</mark> | string | authorization         |
| Authorization<mark style="color:red;">\*</mark>                  | string | Bearer \<auth\_token> |
| Content-Type<mark style="color:red;">\*</mark>                   | string | application/json      |

{% tabs %}
{% tab title="200 " %}
{% code overflow="wrap" %}

```json
{"username":"johndoe",
"email":"john@example.com",
"course_id":"course-v1:MOOCit-demo-1",
"display_name": "MOOCit demonstration Course #1",
"percent_grade":"0.80",
"letter_grade":"Pass",
"passed_timestamp":"2020-03-28 23:21:24.354019"
"last_date":"2020-11-26"
}, 
{"username":"johndoe",
"email":"john@example.com",
"course_id":"course-v1:MOOCit-demo-1",
"display_name": "MOOCit demonstration Course #1",
"percent_grade":"0.20",
"letter_grade":"",
"passed_timestamp":null
"last_date":"2020-11-26"
}
...
```

{% endcode %}
{% endtab %}
{% endtabs %}