# Queries / Security

# Security

**Query**
## securityEvent — Returns [SecurityEvent](/documentation/Objects/Security-Event#SecurityEvent)

**Scopes required:** see_security_events

| Arguments | Type | Description |
| --- | --- | --- |
| id | [ID!](/documentation/Types/UUID#UUID) | The ID of the security event |

**Example Query**

```graphql
query GetSecurityEvent($id: ID!) {
    securityEvent(id: $id) {
        id,
        deviceId,
        event,
        metaData,
        ipv4
    }
}

# Example variables
{
    "id": "<ID>"
}
```

**Query**
## securityEvents — Returns [ConnectionType](/documentation/General/Connections) of [SecurityEvent](/documentation/Objects/Security-Event#SecurityEvent)

**Scopes required:** see_security_events

| Arguments | Type | Description |
| --- | --- | --- |
| outlets | [[ID]](/documentation/Types/UUID#UUID) | A list of outlets to filter the events by |
| registers | [[ID]](/documentation/Types/UUID#UUID) | A list of registers to filter the events by |
| users | [[ID]](/documentation/Types/UUID#UUID) | A list of users to filter the events by |
| eventsSince | [DateTime](/documentation/Types/Date-Time#DateTime) | Get the events since this time (inclusive) |
| eventsBefore | [DateTime](/documentation/Types/Date-Time#DateTime) | Get the events before this time (inclusive) |

**Example Query**

```graphql
query GetSecurityEvents($outlets: [ID]) {
    securityEvents(outlets: $outlets) {
        edges {
            node {
                id,
                deviceId,
                event,
                metaData,
                ipv4
            }
        },
        pageInfo {
            hasNextPage,
            endCursor
        }
    }
}

# Example variables
{
    "outlets": [
        "<OUTLETS>"
    ]
}
```