# V3 Signal Violations

## Get violations as a result of policy enforcement on signals.

> Retrieves DLP v3 signal related violations for a given time range

```json
{"openapi":"3.0.1","info":{"title":"Agent API","version":"25.8.1"},"servers":[{"url":"youragentURL.symphony.com/agent"}],"paths":{"/v3/dlp/violations/signal":{"get":{"tags":["Violations"],"summary":"Get violations as a result of policy enforcement on signals.","description":"Retrieves DLP v3 signal related violations for a given time range","parameters":[{"name":"startTime","in":"query","description":"Timestamp of the first required violation.\nThis is a long integer value representing milliseconds since Jan 1 1970\n","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"endTime","in":"query","description":"Timestamp of the last required violation.\nThis is a long integer value representing milliseconds since Jan 1 1970\nIf unspecified, it will default to current time of the request.\n","schema":{"type":"integer","format":"int64"}},{"name":"next","in":"query","description":"Offset of the next chunk of violations. Value is null for the first request.","schema":{"type":"string"}},{"name":"limit","in":"query","description":"Max No. of violations to return. If no value is provided, 50 is the default. The maximum supported value is 500.\n","schema":{"type":"integer"}},{"name":"sessionToken","in":"header","description":"Session authentication token.","required":true,"schema":{"type":"string"}},{"name":"keyManagerToken","in":"header","description":"Key Manager authentication token.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V3DLPViolationSignalResponse"}}}},"204":{"description":"No Messages.","content":{}},"400":{"description":"Client error, see response body for further details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized: Session tokens invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden: Caller lacks necessary entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error, see response body for further details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"V3DLPViolationSignalResponse":{"type":"object","required":["violations"],"properties":{"violations":{"type":"array","description":"A representation of list of violations due to signal creation/update sent by a user of Symphony","items":{"$ref":"#/components/schemas/V3DLPViolationSignal"}},"nextOffset":{"type":"string","description":"Offset for the next chunk of violations to be submitted in the next request.\nValue is null if there are no further violations.\n"}}},"V3DLPViolationSignal":{"type":"object","properties":{"violation":{"$ref":"#/components/schemas/V3DLPViolation"},"signal":{"$ref":"#/components/schemas/V1DLPSignal"}}},"V3DLPViolation":{"type":"object","properties":{"enforcementEventID":{"type":"string","description":"Enforcement event ID. Unique ID that identifies this enforcement."},"entityID":{"type":"string","description":"Entity ID is the content Id of the violation. For example, for messages it's the Id of the message"},"createTime":{"type":"integer","description":"Timestamp of the violation in milliseconds since Jan 1 1970","format":"int64"},"lastModified":{"type":"integer","description":"Timestamp of the last modification of violation in milliseconds since Jan 1 1970","format":"int64"},"requesterId":{"type":"integer","description":"Id of the requester responsible for the message/stream/signal","format":"int64"},"details":{"type":"array","description":"JSON representation of the details of the violation.","items":{"type":"object"}},"action":{"type":"string","description":"action taken such as BLOCK or WARN.  See outcome for a more detailed description of the outcome this action."},"outcome":{"$ref":"#/components/schemas/V1DLPOutcome"},"version":{"type":"string","description":"Version of application which processed the message and produced this violation."},"ignoreDLPwarning":{"type":"boolean","description":"Did the user chose to ignore DLP warning that was presented?"}},"description":"A representation of a violation due to an event created by a user of Symphony"},"V1DLPOutcome":{"type":"object","properties":{"type":{"type":"string","description":"Outcome of DLP enforcement"}},"description":"A representation of outcome of DLP message/stream/signal sent by a user of Symphony"},"V1DLPSignal":{"type":"object","properties":{"id":{"type":"string","description":"Unique ID of the Signal"},"name":{"type":"string","description":"Name of the Signal"},"rules":{"type":"string","description":"Signal rules decrypted."},"diagnostic":{"type":"string","description":"A diagnostic message containing an error message in the event that the\nsignal decryption failed. May also be present in the case of a successful\ncall if there is useful narrative to return.\n"}},"description":"Signal details"},"Error":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}}}}
```

> #### 🚧 Required Permissions
>
> Calling this endpoint requires the Expression Filter Policy Management role.\
> See [Bot Permissions](https://docs.developers.symphony.com/building-bots-on-symphony/configuration/bot-permissions) for a list of roles and associated privileges.