# Logs requests

```json metadata
{
  "schema_version": 2,
  "title": "Logs requests",
  "description": "Cluster event logs requests",
  "categories": ["docs","operate","rs"],
  "tableOfContents": {"sections":[{"children":[{"id":"get-request","title":"Request"},{"id":"get-response","title":"Response"},{"id":"get-status-codes","title":"Status codes"}],"id":"get-logs","title":"Get cluster events log"}]}

,
  "codeExamples": []
}
```


| Method | Path | Description |
|--------|------|-------------|
| [GET](#get-logs) | `/v1/logs` | Get cluster events log |

## Get cluster events log {#get-logs}

	GET /v1/logs

Get cluster events log.

#### Required permissions

| Permission name |
|-----------------|
| [view_logged_events](https://redis.io/docs/latest/operate/rs/references/rest-api/permissions#view_logged_events) |

### Request {#get-request} 

#### Example HTTP request

	GET /v1/logs?order=desc 


#### Request headers

| Key | Value | Description |
|-----|-------|-------------|
| Host | cnm.cluster.fqdn | Domain name |
| Accept | application/json | Accepted media type |


#### Query parameters

| Field | Type | Description |
|-------|------|-------------|
| stime | ISO_8601 | Start time before which we don't want events. (optional) |
| etime | ISO_8601 | End time after which we don't want events. (optional) |
| order | string | desc/asc - get events in descending or ascending order. Defaults to asc. |
| limit | integer | Maximum number of events to return. (optional) |
| offset | integer | Skip offset events before returning first one (useful for pagination). (optional) |

### Response {#get-response} 

Returns a JSON array of events.

#### Example JSON body

```json
[
  {
    "time": "2014-08-29T11:19:49Z",
    "type": "bdb_name_updated",
    "severity": "INFO",
    "bdb_uid": "1",
    "old_val": "test",
    "new_val": "test123"
  },
  {
    "time": "2014-08-29T11:18:48Z",
    "type": "cluster_bdb_created",
    "severity": "INFO",
    "bdb_uid": "1",
    "bdb_name": "test"
  },
  {
    "time": "2014-08-29T11:17:49Z",
    "type": "cluster_node_joined",
    "severity": "INFO",
    "node_uid": 2
  }
]
```

#### Event object

| Field | Description |
|-------|-------------|
| time | Timestamp when event happened. |
| type | Event type. Additional fields may be available for certain event types. |
| additional fields | Additional fields may be present based on event type.|

### Status codes {#get-status-codes} 

| Code | Description |
|------|-------------|
| [200 OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1) | No error |