> ## Documentation Index > Fetch the complete documentation index at: https://docs.provisionapp.io/llms.txt > Use this file to discover all available pages before exploring further. # List signal incidents > List the Signal Incidents belonging to the partner the API key belongs to. A Signal Incident is raised when a conversation pages someone, and stays open until an agent resolves it. An incident nobody has closed yet is reported with `status: "pending"`; filter on that value to see only open incidents. Supports pagination (`limit`, `offset`), `filters` (a URL-encoded JSON array of `{ attribute, operator, value }` conditions) and `sort`; newest first by default. Notification contact details are never returned. Requires the `signalIncident:read` scope. ## OpenAPI ````yaml /openapi.yaml get /v1/signal-incident/list openapi: 3.1.0 info: title: ProVision Public API version: 1.0.0 description: >- Use the ProVision Public API to integrate with ProVision conversations, clients, users, and addresses. All endpoints accept and return JSON, are authenticated with an `x-api-key` header, and are scoped to a single partner tenant. contact: email: support@onevisionresources.com name: OneVision Resources Support license: name: Proprietary servers: - url: https://connect.provisionapp.io description: Production security: [] paths: /v1/signal-incident/list: get: tags: - signal-incident summary: List signal incidents description: >- List the Signal Incidents belonging to the partner the API key belongs to. A Signal Incident is raised when a conversation pages someone, and stays open until an agent resolves it. An incident nobody has closed yet is reported with `status: "pending"`; filter on that value to see only open incidents. Supports pagination (`limit`, `offset`), `filters` (a URL-encoded JSON array of `{ attribute, operator, value }` conditions) and `sort`; newest first by default. Notification contact details are never returned. Requires the `signalIncident:read` scope. operationId: listSignalIncidents parameters: - schema: type: integer minimum: 1 maximum: 100 default: 20 required: false name: limit in: query - schema: type: - integer - 'null' minimum: 0 default: 0 required: false name: offset in: query - schema: type: string required: false name: search in: query - schema: type: string description: >- This endpoint does not support expanding related resources; any value is rejected. required: false description: >- This endpoint does not support expanding related resources; any value is rejected. name: include in: query - schema: type: string description: >- A URL-encoded JSON array of filter conditions, all AND-ed together. Each condition is `{ "attribute", "operator", "value", "valueType"? }`. Allowed attributes: id, conversationId, status, urgency, notificationTargetType, resolverId, createdAt, resolvedAt, updatedAt. Allowed operators: =, !=, in, not_in, ilike, not_ilike, <, <=, >, >=, is_null, is_not_null. `value` is always a string; set `valueType` (one of boolean, number, number[], string, string[]) to coerce it — e.g. `"boolean"` for a true/false attribute or `"string[]"` for the `in` operator. required: false description: >- A URL-encoded JSON array of filter conditions, all AND-ed together. Each condition is `{ "attribute", "operator", "value", "valueType"? }`. Allowed attributes: id, conversationId, status, urgency, notificationTargetType, resolverId, createdAt, resolvedAt, updatedAt. Allowed operators: =, !=, in, not_in, ilike, not_ilike, <, <=, >, >=, is_null, is_not_null. `value` is always a string; set `valueType` (one of boolean, number, number[], string, string[]) to coerce it — e.g. `"boolean"` for a true/false attribute or `"string[]"` for the `in` operator. name: filters in: query examples: equals: summary: Exact match value: '[{"attribute":"id","operator":"=","value":"example"}]' anyOf: summary: Match any of several values (`in`) value: >- [{"attribute":"id","operator":"in","value":"a,b,c","valueType":"string[]"}] contains: summary: Case-insensitive contains (`ilike`) value: '[{"attribute":"id","operator":"ilike","value":"%term%"}]' isSet: summary: Attribute is not null (`is_not_null`) value: '[{"attribute":"id","operator":"is_not_null","value":""}]' dateRange: summary: Range — multiple conditions are AND-ed value: >- [{"attribute":"createdAt","operator":">=","value":"2026-01-01T00:00:00.000Z"},{"attribute":"createdAt","operator":"<=","value":"2026-12-31T23:59:59.000Z"}] - schema: type: string description: >- Comma-separated list of fields to sort by, applied in order; prefix a field with `-` for descending. Allowed fields: createdAt, resolvedAt, updatedAt, status, urgency. required: false description: >- Comma-separated list of fields to sort by, applied in order; prefix a field with `-` for descending. Allowed fields: createdAt, resolvedAt, updatedAt, status, urgency. name: sort in: query examples: descending: summary: Single field, descending value: '-createdAt' multiple: summary: Multiple keys (first descending, then ascending) value: '-createdAt,resolvedAt' responses: '200': description: Paginated list of signalIncidents content: application/json: schema: $ref: '#/components/schemas/SignalIncidentList' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Unprocessable Entity content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - OpenApiKeyAuth: [] components: schemas: SignalIncidentList: type: object properties: data: type: array items: $ref: '#/components/schemas/SignalIncident' meta: $ref: '#/components/schemas/PaginationMeta' required: - data - meta ErrorResponse: type: object properties: error: $ref: '#/components/schemas/ApiError' required: - error SignalIncident: type: object properties: id: type: string format: uuid conversationId: type: string format: uuid status: $ref: '#/components/schemas/SignalIncidentStatus' urgency: $ref: '#/components/schemas/SignalIncidentUrgency' notificationTargetType: $ref: '#/components/schemas/SignalIncidentNotificationTargetType' createdAt: type: string format: date-time updatedAt: type: string format: date-time resolvedAt: type: - string - 'null' format: date-time description: When an agent resolved the incident. Null while it is unresolved. resolverId: type: - string - 'null' description: >- Id of the user who resolved the incident. May reference a ProVision internal user, who is not visible through `/v1/user/list`. example: ovuid-2b6d4d8e-9f1a-4b2c-8d4e-5f6011223344 required: - id - conversationId - status - urgency - notificationTargetType - createdAt - updatedAt - resolvedAt - resolverId additionalProperties: false PaginationMeta: type: object properties: total: type: integer description: Total number of matching records limit: type: integer description: Page size used for this response offset: type: integer description: Offset used for this response required: - total - limit - offset ApiError: type: object properties: code: type: string description: Machine-readable error code example: NOT_FOUND message: type: string description: Human-readable error description required: - code - message SignalIncidentStatus: type: string enum: - pending - canceled - resolved - ignored SignalIncidentUrgency: type: - string - 'null' enum: - life_safety - urgent - normal - low - null SignalIncidentNotificationTargetType: type: - string - 'null' enum: - partner - platform - null description: >- Who was notified about this incident. `partner` means the partner's own on-call agents; `platform` means ProVision internal staff. securitySchemes: OpenApiKeyAuth: type: apiKey in: header name: x-api-key description: Send the API key in the x-api-key header. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.