# Essay Marker

## Mark an Essay

<mark style="color:green;">`POST`</mark> `https://api.autogon.ai/api/v1/services/essay-marker/`

#### Headers

| Name                                           | Type   | Description      |
| ---------------------------------------------- | ------ | ---------------- |
| Content-Type<mark style="color:red;">\*</mark> | String | application/json |

#### Request Body

| Name                                                          | Type    | Description                               |
| ------------------------------------------------------------- | ------- | ----------------------------------------- |
| essay<mark style="color:red;">\*</mark>                       | String  | Candidate's essay answer                  |
| question<mark style="color:red;">\*</mark>                    | String  | essay question                            |
| answer                                                        | String  | Reference answer for evaluation. Optional |
| required\_number\_of\_words<mark style="color:red;">\*</mark> | Integer | Required word count for the essay.        |

{% tabs %}
{% tab title="200: OK Successful request" %}

```json
{
  "response_id": "b54021b9-dba9-4132-aabb-31a48318931b",
  "data": {
    "grammatically_correct_score": 95,
    "meaning_score": 90,
    "structure_score": 93,
    "average_score_w4": 93,
    "known_history_score": 0
  }
}
```

{% endtab %}

{% tab title="400: Bad Request" %}
{% code fullWidth="true" %}

```json
{
    "response_id": "b54021b9-dba9-4132-aabb-31a48318931b",
    "error":"Error occurred while marking the essay"
}
```

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