Dow Jones Alert Export API

openapi: 3.2.0
info:
  title: Advanced Screening and Monitoring Alert Export API
  description: 'Dow Jones


    ### Rate limits


    Most endpoints are subject to a general rate limit of 10,000 requests per user per 15 minutes.


    Some endpoints are also subject to a global concurrent request limit of 5 simultaneous requests per customer.'
  version: '3'
  license: {}
  contact: {}
servers:
- url: API_INSTANCE
security:
- basicAuth: []
- jwt: []
- clientCert: []
tags:
- name: Alert Export
  description: The Alert Export API allows clients to export details of alerts, alert evidence and alert activities.
paths:
  /alert/export/jsonl:
    post:
      summary: Export alerts
      description: 'Request to export alerts in the system as JSON-L format.

        ### Rate Limits


        This endpoint is subject to a general rate limit of 10,000 requests per user per 15 minutes, and a global concurrent request limit of 5 simultaneous requests per customer.


        <!-- operational-characteristics:start -->


        ### Operational characteristics


        Values below are measured from production traffic. Only collected values are shown.


        **Latency distribution**


        Latency values are shown as milliseconds below 1 s, seconds with one decimal place below 1 min, otherwise as M:SS (min).


        | Metric | Value |

        | --- | --- |

        | Median | 90 ms |

        | 90th percentile | 460 ms |

        | 95th percentile | 561 ms |

        | 98th percentile | 651 ms |

        | 99th percentile | 755 ms |

        <!-- operational-characteristics:end -->


        Each alert includes `riskTags` (including custom category stamps such as `cc42-active`) and `tags`

        (including `userTag-{pillLabel}-active|inactive` entries derived from those stamps when custom

        categories are enabled). No separate `customCategories` property is returned.


        Please note, at scale some queries to this endpoint may slowdown. Please test your particular access pattern at the scale you are running at.

        '
      operationId: alertExport
      tags:
      - Alert Export
      x-operational-characteristics:
        description: 'Operational characteristics from production log analysis (generatedAt: 2026-06-16T10:56:29.271Z).

          '
        latencyDistribution:
          median: 89.07
          p90: 459.66
          p95: 560.44
          p98: 650.23
          p99: 754.4
          sampleSize: 196722846
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - alertFilter
              properties:
                alertFilter:
                  allOf:
                  - type: object
                    required:
                    - filters
                    properties:
                      filters:
                        type: array
                        items:
                          oneOf:
                          - type: object
                            properties:
                              tags:
                                oneOf:
                                - type: array
                                  items:
                                    type: string
                                  example:
                                  - policy-10127
                                - type: string
                                  example: policy-10127
                              previousAssignees:
                                type: object
                                properties:
                                  includes:
                                    type: array
                                    items:
                                      type: number
                                    example:
                                    - 10034
                                  excludes:
                                    type: array
                                    items:
                                      type: number
                                    example:
                                    - 10034
                              id:
                                oneOf:
                                - type: array
                                  items:
                                    type: number
                                  example:
                                  - 10001
                                - type: number
                                  example: 10001
                              type:
                                oneOf:
                                - type: array
                                  items:
                                    type: number
                                  example:
                                  - 10127
                                - type: number
                                  example: 10127
                              state:
                                oneOf:
                                - type: array
                                  items:
                                    type: integer
                                  example:
                                  - 10127
                                - type: integer
                                  example: 10127
                              score:
                                type: object
                                properties:
                                  gte:
                                    type: number
                                    example: 0
                                  lte:
                                    type: number
                                    example: 120
                                  gt:
                                    type: number
                                    example: 40
                                  lt:
                                    type: number
                                    example: 100
                              docCount:
                                type: object
                                properties:
                                  gte:
                                    type: number
                                    example: 0
                                  lte:
                                    type: number
                                    example: 120
                                  gt:
                                    type: number
                                    example: 40
                                  lt:
                                    type: number
                                    example: 100
                              currentStatus.status:
                                type: object
                                properties:
                                  gte:
                                    type: number
                                    example: 10
                                  lte:
                                    type: number
                                    example: 2000
                                  gt:
                                    type: number
                                    example: 1
                                  lt:
                                    type: number
                                    example: 100
                              time.created:
                                type: object
                                properties:
                                  gte:
                                    type: number
                                    example: 1590973346512
                                  lte:
                                    type: number
                                    example: 1590973346512
                                  gt:
                                    type: number
                                    example: 1590973346512
                                  lt:
                                    type: number
                                    example: 1590973346512
                              time.lastEvidence:
                                type: object
                                properties:
                                  gte:
                                    type: number
                                    example: 1590973346512
                                  lte:
                                    type: number
                                    example: 1590973346512
                                  gt:
                                    type: number
                                    example: 1590973346512
                                  lt:
                                    type: number
                                    example: 1590973346512
                              time.lastUpdated:
                                type: object
                                properties:
                                  gte:
                                    type: number
                                    example: 1590973346512
                                  lte:
                                    type: number
                                    example: 1590973346512
                                  gt:
                                    type: number
                                    example: 1590973346512
                                  lt:
                                    type: number
                                    example: 1590973346512
                                target:
                                  description: The IDs of the client of clients to fetch alerts for. Note that the client IDs must have the prefix "eoi:"
                                  oneOf:
                                  - type: array
                                    items:
                                      type: string
                                    example:
                                    - eoi:<client id>
                                  - type: string
                                    example: eoi:<client id>
                          - type: object
                            description: recursive filters
                            properties:
                              operator:
                                type: string
                                description: high level boolean operator (default "AND")
                                enum:
                                - AND
                                - OR
                              filters:
                                description: recursive filters
                                type: object
                                required:
                                - filters
                                properties:
                                  filters:
                                    type: array
                                    items:
                                      oneOf:
                                      - type: object
                                        properties:
                                          tags:
                                            oneOf:
                                            - type: array
                                              items:
                                                type: string
                                              example:
                                              - policy-10127
                                            - type: string
                                              example: policy-10127
                                          previousAssignees:
                                            type: object
                                            properties:
                                              includes:
                                                type: array
                                                items:
                                                  type: number
                                                example:
                                                - 10034
                                              excludes:
                                                type: array
                                                items:
                                                  type: number
                                                example:
                                                - 10034
                                          id:
                                            oneOf:
                                            - type: array
                                              items:
                                                type: number
                                              example:
                                              - 10001
                                            - type: number
                                              example: 10001
                                          type:
                                            oneOf:
                                            - type: array
                                              items:
                                                type: number
                                              example:
                                              - 10127
                                            - type: number
                                              example: 10127
                                          state:
                                            oneOf:
                                            - type: array
                                              items:
                                                type: integer
                                              example:
                                              - 10127
                                            - type: integer
                                              example: 10127
                                          score:
                                            type: object
                                            properties:
                                              gte:
                                                type: number
                                                example: 0
                                              lte:
                                                type: number
                                                example: 120
                                              gt:
                                                type: number
                                                example: 40
                                              lt:
                                                type: number
                                                example: 100
                                          docCount:
                                            type: object
                                            properties:
                                              gte:
                                                type: number
                                                example: 0
                                              lte:
                                                type: number
                                                example: 120
                                              gt:
                                                type: number
                                                example: 40
                                              lt:
                                                type: number
                                                example: 100
                                          currentStatus.status:
                                            type: object
                                            properties:
                                              gte:
                                                type: number
                                                example: 10
                                              lte:
                                                type: number
                                                example: 2000
                                              gt:
                                                type: number
                                                example: 1
                                              lt:
                                                type: number
                                                example: 100
                                          time.created:
                                            type: object
                                            properties:
                                              gte:
                                                type: number
                                                example: 1590973346512
                                              lte:
                                                type: number
                                                example: 1590973346512
                                              gt:
                                                type: number
                                                example: 1590973346512
                                              lt:
                                                type: number
                                                example: 1590973346512
                                          time.lastEvidence:
                                            type: object
                                            properties:
                                              gte:
                                                type: number
                                                example: 1590973346512
                                              lte:
                                                type: number
                                                example: 1590973346512
                                              gt:
                                                type: number
                                                example: 1590973346512
                                              lt:
                                                type: number
                                                example: 1590973346512
                                          time.lastUpdated:
                                            type: object
                                            properties:
                                              gte:
                                                type: number
                                                example: 1590973346512
                                              lte:
                                                type: number
                                                example: 1590973346512
                                              gt:
                                                type: number
                                                example: 1590973346512
                                              lt:
                                                type: number
                                                example: 1590973346512
                                            target:
                                              description: The IDs of the client of clients to fetch alerts for. Note that the client IDs must have the prefix "eoi:"
                                              oneOf:
                                              - type: array
                                                items:
                                                  type: string
                                                example:
                                                - eoi:<client id>
                                              - type: string
                                                example: eoi:<client id>
                                      - type: object
                                        description: recursive filters
                                        properties:
                                          operator:
                                            type: string
                                            description: high level boolean operator (default "AND")
                                            enum:
                                            - AND
                                            - OR
                                          filters:
                                            description: recursive filters
                  - type: object
                    properties:
                      skip:
                        type: integer
                        default: 0
                        description: The number of records to skip.
                      limit:
                        type: integer
                        default: 100
                        description: The number of records to return. Setting this to zero (0) returns all records.
                      sort:
                        type: string
                        example: time.created:-1
                        enum:
                        - id:-1
                        - id:1
                        - time.created:-1
                        - time.created:1
                        - time.lastEvidence:-1
                        - time.lastEvidence:1
                        - time.lastUpdated:-1
                        - time.lastUpdated:1
                        - currentStatus.status:-1
                        - currentStatus.status:1
                        - target:-1
                        - target:1
                        - state:-1
                        - state:1
                        - score:-1
                        - score:1
                        - docCount:1
                        - docCount:-1
                      operator:
                        type: string
                        description: high level boolean operator (default "AND")
                        enum:
                        - AND
                        - OR
                projections:
                  type: object
                  description: set of fields to return
                  example:
                    client:
                      clientId: true
                      name: true
                      entityType: true
                  properties:
                    client:
                      type: object
                      description: 'An object defining the client fields that should be returned in the response.  The object should consist of properties whose names match the client field to be included, and whose value should been the boolean flag `true`. Consult the client import schema for details.

                        '
                      links:
                        clientImport:
                          operationId: clientBulkImport
                      properties:
                        clientFieldName:
                          type: boolean
                          description: Replace clientFieldName with the name of the client field to be returned, for example `name`
              components:
                schemas:
                  AlertFilter:
                    allOf:
                    - type: object
                      required:
                      - filters
                      properties:
                        filters:
                          type: array
                          items:
                            oneOf:
                            - type: object
                              properties:
                                tags:
                                  oneOf:
                                  - type: array
                                    items:
                                      type: string
                                    example:
                                    - policy-10127
                                  - type: string
                                    example: policy-10127
                                previousAssignees:
                                  type: object
                                  properties:
                                    includes:
                                      type: array
                                      items:
                                        type: number
                                      example:
                                      - 10034
                                    excludes:
                                      type: array
                                      items:
                                        type: number
                                      example:
                                      - 10034
                                id:
                                  oneOf:
                                  - type: array
                                    items:
                                      type: number
                                    example:
                                    - 10001
                                  - type: number
                                    example: 10001
                                type:
                                  oneOf:
                                  - type: array
                                    items:
                                      type: number
                                    example:
                                    - 10127
                                  - type: number
                                    example: 10127
                                state:
                                  oneOf:
                                  - type: array
                                    items:
                                      type: integer
                                    example:
                                    - 10127
                                  - type: integer
                                    example: 10127
                                score:
                                  type: object
                                  properties:
                                    gte:
                                      type: number
                                      example: 0
                                    lte:
                                      type: number
                                      example: 120
                                    gt:
                                      type: number
                                      example: 40
                                    lt:
                                      type: number
                                      example: 100
                                docCount:
                                  type: object
                                  properties:
                                    gte:
                                      type: number
                                      example: 0
                                    lte:
                                      type: number
                                      example: 120
                                    gt:
                                      type: number
                                      example: 40
                                    lt:
                                      type: number
                                      example: 100
                                currentStatus.status:
                                  type: object
                                  properties:
                                    gte:
                                      type: number
                                      example: 10
                                    lte:
                                      type: number
                                      example: 2000
                                    gt:
                                      type: number
                                      example: 1
                                    lt:
                                      type: number
                                      example: 100
                                time.created:
                                  type: object
                                  properties:
                                    gte:
                                      type: number
                                      example: 1590973346512
                                    lte:
                                      type: number
                                      example: 1590973346512
                                    gt:
                                      type: number
                                      example: 1590973346512
                                    lt:
                                      type: number
                                      example: 1590973346512
                                time.lastEvidence:
                                  type: object
                                  properties:
                                    gte:
                                      type: number
                                      example: 1590973346512
                                    lte:
                                      type: number
                                      example: 1590973346512
                                    gt:
                                      type: number
                                      example: 1590973346512
                                    lt:
                                      type: number
                                      example: 1590973346512
                                time.lastUpdated:
                                  type: object
                                  properties:
                                    gte:
                                      type: number
                                      example: 1590973346512
                                    lte:
                                      type: number
                                      example: 1590973346512
                                    gt:
                                      type: number
                                      example: 1590973346512
                                    lt:
                                      type: number
                                      example: 1590973346512
                                  target:
                                    description: The IDs of the client of clients to fetch alerts for. Note that the client IDs must have the prefix "eoi:"
                                    oneOf:
                                    - type: array
                                      items:
                                        type: string
                                      example:
                                      - eoi:<client id>
                                    - type: string
                                      example: eoi:<client id>
                            - type: object
                              description: recursive filters
                              properties:
                                operator:
                                  type: string
                                  description: high level boolean operator (default "AND")
                                  enum:
                                  - AND
                                  - OR
                                filters:
                                  description: recursive filters
                                  type: object
                                  required:
                                  - filters
                                  properties:
                                    filters:
                                      type: array
                                      items:
                                        oneOf:
                                        - type: object
                                          properties:
                                            tags:
                                              oneOf:
                                              - type: array
                                                items:
                                                  type: string
                                                example:
                                                - policy-10127
                                              - type: string
                                                example: policy-10127
                                            previousAssignees:
                                              type: object
          

# --- truncated at 32 KB (1989 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dow-jones/refs/heads/main/openapi/dow-jones-alert-export-api-openapi.yml