:

```bash
curl -X POST "http://localhost:8000/api/v1/schools/{school_id}/semester-types" \
-H "Accept: application/json" \
    -d "name"="est" \
    -d "school_id"="est" \

```

```javascript
var settings = {
    "async": true,
    "crossDomain": true,
    "url": "http://localhost:8000/api/v1/schools/{school_id}/semester-types",
    "method": "POST",
    "data": {
        "name": "est",
        "school_id": "est"
},
    "headers": {
        "accept": "application/json"
    }
}

$.ajax(settings).done(function (response) {
    console.log(response);
});
```


### HTTP Request
`POST api/v1/schools/{school_id}/semester-types`

#### Parameters

Parameter | Type | Status | Description
--------- | ------- | ------- | ------- | -----------
    name | string |  required  | 
    school_id | string |  optional  | 

<!-- END_f08dbfafe77aefb01ba34f7969a8e290 -->

<!-- START_8e0d6ee5b77e919f4b3b38c24350323c -->
## Get Semester Type by ID

Responds with a specific Semester Type by its ID

> Example request:

```bash
curl -X GET "http://localhost:8000/api/v1/schools/{school_id}/semester-types/{semester_type}" \
-H "Accept: application/json"
```

```javascript
var settings = {
    "async": true,
    "crossDomain": true,
    "url": "http://localhost:8000/api/v1/schools/{school_id}/semester-types/{semester_type}",
    "method": "GET",
    "headers": {
        "accept": "application/json"
    }
}

$.ajax(settings).done(function (response) {
    console.log(response);
});
```

> Example response:

```json
{
    "id": 1,
    "name": "University of Ibadan",
    "short_name": "UI",
    "owner_id": 1,
    "created_at": "2018-09-11 01:17:38",
    "updated_at": "2018-09-11 01:17:38"
}
```

### HTTP Request
`GET api/v1/schools/{school_id}/semester-types/{semester_type}`

`HEAD api/v1/schools/{school_id}/semester-types/{semester_type}`


<!-- END_8e0d6ee5b77e919f4b3b38c24350323c -->

<!-- START_851f0dd3ec3aba5a448fb78a0521bc8a -->
## Update Semester Type

Modify information about an existing Semester Type by ID
- Rules of Access
 - User is an ADMIN or
 - User owns school the Semester Type belongs to

> Example request:

```bash
curl -X PUT "http://localhost:8000/api/v1/schools/{school_id}/semester-types/{semester_type}" \
-H "Accept: application/json"
```

```javascript
var settings = {
    "async": true,
    "crossDomain": true,
    "url": "http://localhost:8000/api/v1/schools/{school_id}/semester-types/{semester_type}",
    "method": "PUT",
    "headers": {
        "accept": "application/json"
    }
}

$.ajax(settings).done(function (response) {
    console.log(response);
});
```


### HTTP Request
`PUT api/v1/schools/{school_id}/semester-types/{semester_type}`

`PATCH api/v1/schools/{school_id}/semester-types/{semester_type}`


<!-- END_851f0dd3ec3aba5a448fb78a0521bc8a -->

<!-- START_3b1a0d8fe045092745679aec98aea919 -->
## Delete Semester Type

Removes a Semester Type from the System by ID
- Rules of Access
 - User is an ADMIN or
 - User owns school the Semester Type belongs to

> Example request:

```bash
curl -X DELETE "http://localhost:8000/api/v1/schools/{school_id}/semester-types/{semester_type}" \
-H "Accept: application/json"
```

```javascript
var settings = {
    "async": true,
    "crossDomain": true,
    "url": "http://localhost:8000/api/v1/schools/{school_id}/semester-types/{semester_type}",
    "method": "DELETE",
    "headers": {
        "accept": "application/json"
    }
}

$.ajax(settings).done(function (response) {
    console.log(response);
});
```


### HTTP Request
`DELETE api/v1/schools/{school_id}/semester-types/{semester_type}`


<!-- END_3b1a0d8fe045092745679aec98aea919 -->

#Semesters

For Endpoints handling Semesters, which represent a time period, 
 marked by start and end dates, within a Session, and belonging 
 to a Semester Type.
<!-- START_cd7efec5827a031cf8575f41a0ebe2a4 -->
## Get Semesters

Responds with a list Semesters
- Rules of Access
  - User is same school as Semester
- Filters
  -?with_session
  -?with_type

> Example request:

```bash
curl -X GET "http://localhost:8000/api/v1/semesters" \
-H "Accept: application/json"
```

```javascript
var settings = {
    "async": true,
    "crossDomain": true,
    "url": "http://localhost:8000/api/v1/semesters",
    "method": "GET",
    "headers": {
        "accept": "application/json"
    }
}

$.ajax(settings).done(function (response) {
    console.log(response);
});
```

> Example response:

```json
{
    "current_page": 1,
    "data": [
        {
            "id": 1,
            "semester_type_id": 1,
            "session_id": 1,
            "start_date": "2018-09-11 00:00:00",
            "end_date": "2019-03-10 00:00:00",
            "created_at": "2018-09-11 01:17:39",
            "updated_at": "2018-09-11 01:17:39"
        },
        {
            "id": 2,
            "semester_type_id": 2,
            "session_id": 1,
            "start_date": "2019-03-15 00:00:00",
            "end_date": "2019-09-11 00:00:00",
            "created_at": "2018-09-11 01:17:39",
            "updated_at": "2018-09-11 01:17:39"
        }
    ],
    "first_page_url": "http:\/\/localhost\/api\/v1\/semesters?page=1",
    "from": 1,
    "last_page": 1,
    "last_page_url": "http:\/\/localhost\/api\/v1\/semesters?page=1",
    "next_page_url": null,
    "path": "http:\/\/localhost\/api\/v1\/semesters",
    "per_page": 15,
    "prev_page_url": null,
    "to": 2,
    "total": 2
}
```

### HTTP Request
`GET api/v1/semesters`

`HEAD api/v1/semesters`


<!-- END_cd7efec5827a031cf8575f41a0ebe2a4 -->

<!-- START_a8f20c98b3664db1030dfef0fc6aae06 -->
##