openapi: 3.0.0
info:
  title: 'Akamai: API Endpoint Definition Access tokens Events API'
  version: '2'
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  description: View security event data generated on the Akamai platform in your SIEM application.
servers:
- url: https://{hostname}/api-definitions/v2
tags:
- description: View security event data generated on the Akamai platform in your SIEM application.
  name: Events
paths:
  /configs/{configId}:
    parameters:
    - description: Unique identifier for each security configuration. To report on more than one configuration, separate integer identifiers with semicolons.
      in: path
      name: configId
      required: true
      schema:
        example: 12892;29182;82912
        type: string
      x-akamai:
        file-path: parameters/config-id-path.yaml
    x-akamai:
      file-path: paths/config.yaml
      path-info: /configs/{configId}
    get:
      description: "Get security events data from your security configurations using one of two modes: [offset or time-based](https://techdocs.akamai.com/siem-integration/reference/query-parameter-combinations). Each mode orders event logs based on the logs' storage time in the database, not the time when the events actually occurred. This may result in delayed event logs in subsequent offset requests, or older event logs in time-based requests. While both methods have a 5-second latency, using `offset` allows subsequent calls to return logs for the 5 seconds omitted from the previous request. The time-based method omits logs from that 5 seconds of latency, so you may miss some logs from that period.\n\n If the connection is disrupted, use time-based mode to replay security events that occurred in the last 12 hours up to 5 seconds before your requested time range. Use `offset` and `limit` parameters in offset mode. Use `from`, `to`, and `limit` parameters in time-based mode. The potentially large response contains a series of JSON objects, each separated with a line break and each corresponding to a security event. The last line of the response is an [offset context](https://techdocs.akamai.com/siem-integration/reference/offsetcontext) object that provides `total` records fetched, an `offset` to use a starting point for the next batch of data, and any `limit` you specified. Run this operation continuously as long as it returns new logs to ensure you don't miss any. The API may return a maximum of 600,000 logs per request, while your configurations might generate many more in periods of high traffic."
      externalDocs:
        description: See documentation for this operation in Akamai's SIEM Integration API
        url: https://techdocs.akamai.com/siem-integration/reference/get-config
      operationId: get-config
      parameters:
      - description: This token denotes the last message.  If specified, this operation fetches only security events that have occurred since the last `offset` value. Use this parameter for offset mode, not for time-based requests.
        in: query
        name: offset
        schema:
          example: c0bc409010aa6928e57cd5a3000433b9
          type: string
        x-akamai:
          file-path: parameters/offset-query.yaml
      - description: Defines the approximate maximum number of security events each fetch returns, in both offset and time-based modes. The default limit is `10000`, and the maximum limit available is `600000`. Listing an unlimited number of logs isn't possible. Expect requests to return a slightly higher number of security events than you set in the `limit` parameter, because data is stored in different buckets.
        in: query
        name: limit
        schema:
          example: 10
          type: integer
        x-akamai:
          file-path: parameters/limit-query.yaml
      - description: The start of a specified time range, expressed in Unix epoch seconds. You need this to get time-based results for a set period, not for offset mode.
        in: query
        name: from
        schema:
          example: 1488816442
          type: integer
        x-akamai:
          file-path: parameters/from-query.yaml
      - description: 'The end of a specified time range, expressed in Unix epoch seconds. You can''t use this parameter in offset mode, and it''s optional in time-based mode. The value can''t be any greater than the default value: five seconds before the current time.'
        in: query
        name: to
        schema:
          example: 1488816784
          type: integer
        x-akamai:
          file-path: parameters/to-query.yaml
      responses:
        '200':
          content:
            application/json:
              examples:
                01-event-lines:
                  summary: Event lines
                  value:
                    $ref: ../examples/siem-event-200.json
                02-summary:
                  summary: Final metadata line
                  value:
                    $ref: ../examples/siem-response-context.json
              schema:
                description: A series of events arranged as separate JSONs, one per line of output within the response body. The final line offers contextual metadata for further requests. See [Multi-JSON responses](https://techdocs.akamai.com/siem-integration/reference/multi-json-response-format-1).
                oneOf:
                - additionalProperties: false
                  description: This object encapsulates each security event. Each line of response body output represents one of these objects, except for the last, which is an [offset context](https://techdocs.akamai.com/siem-integration/reference/offsetcontext) object.
                  properties:
                    attackData:
                      additionalProperties: false
                      description: Characterizes the nature of each attack and provides details on the set of configuration rules that intercepted it. Each rule-related member encodes a conceptual array of faceted data for more than one rule. See [Configuration rule data](https://techdocs.akamai.com/siem-integration/reference/configuration-rule) for details.
                      properties:
                        apiId:
                          description: For attacks on API services, this is a unique identifier under which the API is protected. It corresponds to the `apiEndPointId` value in the [API Endpoint Definition API](https://techdocs.akamai.com/api-gateway/reference/api).
                          type: string
                        apiKey:
                          description: For attacks on API services, this is the security you specify. It corresponds to the `apiKeyName` value in the [API Endpoint Definition API](https://techdocs.akamai.com/api-gateway/reference/api).
                          type: string
                        appliedAction:
                          description: The final action applied to the request.
                          type: string
                        clientIP:
                          description: The IP address of the client making the request.
                          type: string
                        clientReputation:
                          description: For Client Reputation customers, this provides data on the client IP's reputation. For example, `ID=172.19.185.64;WEBATCK=9;DOSATCK=9`. See the [Client Reputation Integration Guide](https://control.akamai.com/dl/customers/KONA/ClientReputation/ClientRep_IntegrationGuide.pdf) for details.
                          type: string
                        configId:
                          description: Unique identifier for the security configuration that applied to this request.
                          type: string
                        policyId:
                          description: Unique identifier for the firewall policy applied to this request. Each security configuration may contain more than one policy.
                          type: string
                        ruleActions:
                          description: Identifies whether the request was aborted (`deny`) or allowed to pass with a warning logged (`alert`). See [Configuration rule data](https://techdocs.akamai.com/siem-integration/reference/configuration-rule) for information on decoding this value.
                          type: string
                        ruleData:
                          description: User-supplied values that led each rule to trigger, typically suspect text that appears somewhere in the request, or a specified Client Reputation score. See [Configuration rule data](https://techdocs.akamai.com/siem-integration/reference/configuration-rule) for information on decoding this value.
                          type: string
                        ruleMessages:
                          description: The message reported by each triggered rule. See [Configuration rule data](https://techdocs.akamai.com/siem-integration/reference/configuration-rule) for information on decoding this value.
                          type: string
                        ruleSelectors:
                          description: Identifies the location in the request that triggered each rule, such as the name of an HTTP header. See [Configuration rule data](https://techdocs.akamai.com/siem-integration/reference/configuration-rule) for information on decoding this value.
                          type: string
                        ruleTags:
                          description: Represents a set of categories for the triggered rule. See [Configuration rule data](https://techdocs.akamai.com/siem-integration/reference/configuration-rule) for information on decoding this value.
                          type: string
                        ruleVersions:
                          description: The version of each triggered rule. See [Configuration rule data](https://techdocs.akamai.com/siem-integration/reference/configuration-rule) for information on decoding this value.
                          type: string
                        rules:
                          description: A series of identifiers for rules within the configuration that triggered for this request. See [Configuration rule data](https://techdocs.akamai.com/siem-integration/reference/configuration-rule) for information on decoding this value.
                          type: string
                        slowPostAction:
                          description: For any detected slow POST attack, this indicates the resulting action, either `W` for a warning, or `A` for abort (deny). It appears only when slow POST protection triggers.
                          enum:
                          - W
                          - A
                          type: string
                        slowPostRate:
                          description: For any detected slow POST attack, this indicates the recorded rate of the attack in bytes per second. It appears only when slow POST protection triggers.
                          type: string
                      required:
                      - ruleMessages
                      - ruleSelectors
                      - rules
                      - ruleActions
                      - ruleVersions
                      - ruleData
                      - policyId
                      - configId
                      - clientIP
                      - ruleTags
                      - appliedAction
                      type: object
                    botData:
                      additionalProperties: false
                      description: An optional object that contains Bot Score data. This object is only available to Bot Manager customers on endpoints with Bot Score enabled.
                      properties:
                        botScore:
                          description: Bot score for protected requests, expressed as a string-formatted percentage value.
                          type: string
                        responseSegment:
                          description: 'Response Segment indicator: `0` - human, `1` - cautious response, `2` - strict response, `3` - aggressive response, `4` - safeguard.'
                          enum:
                          - '0'
                          - '1'
                          - '2'
                          - '3'
                          - '4'
                          type: string
                      required:
                      - botScore
                      - responseSegment
                      type: object
                    clientData:
                      additionalProperties: false
                      description: An optional object that contains client information. This object is only available to Bot Manager customers and only on endpoints configured for bot endpoint protection.
                      properties:
                        appBundleId:
                          description: The app bundle ID. This is present only if the telemetry type is native app SDK telemetry.
                          type: string
                        appVersion:
                          description: The app version. This is present only if the telemetry type is native app SDK telemetry.
                          type: string
                        sdkVersion:
                          description: Native App Traffic Protection SDK Version. This is present only if the telemetry type is native app SDK telemetry.
                          type: string
                        telemetryType:
                          description: 'The telemetry type for this client request: `0` for web client standard telemetry, `1` for web client inline telemetry, or `2` for native app SDK telemetry.'
                          enum:
                          - '0'
                          - '1'
                          - '2'
                          type: string
                      required:
                      - telemetryType
                      type: object
                    custom:
                      description: A customizable value to distinguish subsets of content. Contact Akamai Professional Services for help configuring the `custom` field. Size limit is 2KB. See [Configuration rule data](https://techdocs.akamai.com/siem-integration/reference/configuration-rule) for information on decoding this value.
                      type: string
                    format:
                      description: The format of the data representing this security event, `json` in this context.
                      enum:
                      - json
                      type: string
                    geo:
                      additionalProperties: false
                      description: Encapsulates location data for the attack's source.
                      properties:
                        asn:
                          description: The AS number or numbers that the IP belongs to.
                          type: string
                        city:
                          description: The city to which the IP address maps.
                          type: string
                        continent:
                          description: A two-letter code for the continent to which the IP address maps.
                          type: string
                        country:
                          description: A two-letter ISO 3166 code for the country to which the IP address maps.
                          type: string
                        regionCode:
                          description: A two-letter ISO 3166 code representing the state, province, or region to which the IP address maps.
                          type: string
                      required:
                      - country
                      - asn
                      - regionCode
                      - continent
                      - city
                      type: object
                    httpMessage:
                      additionalProperties: false
                      description: Provides context on each attack's HTTP request.
                      properties:
                        bytes:
                          description: The number of bytes served in the response, represented as a string-formatted integer.
                          type: string
                        host:
                          description: The incoming client request's `Host` header.
                          type: string
                        method:
                          description: The request's HTTP method, either `GET`, `POST`, `PUT`, `DELETE`, `HEAD`, or `OPTIONS`.
                          enum:
                          - GET
                          - POST
                          - DELETE
                          - PUT
                          - HEAD
                          - OPTIONS
                          type: string
                        path:
                          description: The server path from the client's requested URL, excluding query strings.
                          type: string
                        port:
                          description: The port number for the incoming request, string-formatted either as `80` or `443`.
                          enum:
                          - '80'
                          - '443'
                          type: string
                        protocol:
                          description: The request protocol.
                          type: string
                        query:
                          description: The client request's full query string.
                          type: string
                        requestHeaders:
                          description: The full set of URL-encoded request headers.
                          type: string
                        requestId:
                          description: A unique identifier for each request.
                          type: string
                        responseHeaders:
                          description: The full set of URL-encoded response headers.
                          type: string
                        start:
                          description: A string representation of the epoch time when the edge server initiated the connection for the request.
                          type: string
                        status:
                          description: The HTTP response status code sent to the client.
                          type: string
                        tls:
                          description: TLS version if applicable, which corresponds to the `AK_TLS_VERSION`.
                          type: string
                      required:
                      - status
                      - protocol
                      - requestHeaders
                      - bytes
                      - method
                      - start
                      - host
                      - requestId
                      - query
                      - path
                      - responseHeaders
                      - port
                      type: object
                    identity:
                      additionalProperties: false
                      description: An optional object with data about client identifiers enabled in your security configuration.
                      properties:
                        ja4:
                          description: A JA4 TLS client fingerprint value.
                          minLength: 1
                          type: string
                        tlsFingerprintV2:
                          description: A client TLS fingerprint V2 value.
                          type: string
                        tlsFingerprintV3:
                          description: A client TLS fingerprint V3 value.
                          type: string
                      required:
                      - tlsFingerprintV2
                      - tlsFingerprintV3
                      type: object
                    type:
                      description: Characterizes the source of this report data. This value is always `akamai_siem`.
                      enum:
                      - akamai_siem
                      type: string
                    userRiskData:
                      additionalProperties: false
                      description: An optional object that contains user risk data. This object is only available to Identity Protector customers and only on endpoints configured for identity protection.
                      properties:
                        allow:
                          description: A value of `0` means the user wasn't on the allowlist. A value of `1` means the user was on the allowlist.
                          enum:
                          - '0'
                          - '1'
                          type: string
                        emailDomain:
                          description: The domain name extracted from the user's email address.
                          type: string
                        general:
                          description: Indicators, such as users per device and IPs per user, of general behavior observed for relevant attributes.
                          type: string
                        originUserId:
                          description: The unencrypted user ID, provided by the origin.
                          type: string
                        risk:
                          description: Indicators, such as `device`, `geo`, `asn`, `tod`, that increased the calculated risk score.
                          type: string
                        score:
                          description: Risk score, expressed as a string-formatted percentage. A `0` means no risk, and `100` is the highest possible risk.
                          type: string
                        status:
                          description: 'Status code describing any errors that occurred during risk scoring: `0` - no error, `1` - unknown error, `2` - user profile not found, `3` - user profile insufficient for accurate score, `4` - no telemetry received for Bot Manager cookie presented in this request, `5` - calculation timeout, `6` - username not found in client request, `7` - can''t identify user on this non-login request.'
                          enum:
                          - '0'
                          - '1'
                          - '2'
                          - '3'
                          - '4'
                          - '5'
                          - '6'
                          - '7'
                          type: string
                        trust:
                          description: Indicators, such as `device`, `geo`, `asn`, `tod`, that were trusted.
                          type: string
                        username:
                          description: The unencrypted username, provided at login by the user.
                          type: string
                        uuid:
                          description: Unique identifier for the user whose user risk data is provided here.
                          type: string
                      required:
                      - status
                      type: object
                    version:
                      description: The version number for this report's JSON data format.
                      type: string
                  required:
                  - attackData
                  - format
                  - type
                  - version
                  - httpMessage
                  - geo
                  title: Event lines
                  type: object
                  x-akamai:
                    file-path: schemas/siem-event-200.yaml
                - additionalProperties: false
                  description: This object features contextual metadata about the set of security events included in each response and appears on the last line of the response body.
                  properties:
                    limit:
                      description: Appears if the size limit was reached during data fetch.
                      maximum: 600000
                      type: integer
                    offset:
                      description: Identifies the last processed security event in a response. To fetch only those security events that occurred since the last pull, enter this value as an offset parameter.
                      type: string
                    total:
                      description: The number of security events included in the response.
                      type: integer
                  required:
                  - total
                  - limit
                  - offset
                  title: Final metadata line
                  type: object
                  x-akamai:
                    file-path: schemas/siem-response-context.yaml
                x-akamai:
                  file-path: schemas/streamed-response-200.yaml
          description: The response lists security events.
        '400':
          content:
            application/problem+json:
              example:
                clientIp: 192.0.2.239
                detail: Missing mandatory parameter(s) or illegal parameter(s) in the request
                instance: https://akab-1234abcd.luna.akamaiapis.net/siem/v1/configs=12345
                method: GET
                requestId: 9cf81a9
                requestTime: '2023-06-20T15:02:30Z'
                serverIp: 192.0.2.74
                title: Missing mandatory parameter(s) or illegal parameter(s) in the request
                type: https://problems.cloudsecurity.akamaiapis.net/siem/v1/missing-parameters
              schema:
                additionalProperties: true
                description: Encapsulates debugging information for error responses.
                properties:
                  detail:
                    description: Detail error message.
                    type: string
                  errors:
                    description: Further nested problem objects describing individual errors.
                    items:
                      description: A further-nested problem object.
                      type: object
                      x-akamai:
                        file-path: schemas/problem-nested.yaml
                    type: array
                  instance:
                    description: The non-referenceable URI for the error instance.
                    example: https://problems.luna.akamaiapis.net/siem/error-instances/d54686b5-21cb-4ab7-a8d6-a92282cf1749
                    type: string
                  status:
                    description: HTTP status code.
                    example: 404
                    type: integer
                  title:
                    description: Title for the error.
                    example: Not Found
                    type: string
                  type:
                    description: URL for the error type.
                    example: https://problems.luna.akamaiapis.net/siem/error-types/NOT-FOUND
                    type: string
                required:
                - type
                - title
                type: object
                x-akamai:
                  file-path: schemas/problem.yaml
          description: '[Bad request](https://techdocs.akamai.com/siem-integration/reference/400). Invalid request body or URL parameter input.'
          x-akamai:
            file-path: errors/400.yaml
        '403':
          content:
            application/problem+json:
              example:
                clientIp: 192.0.2.85
                detail: The specified user is unauthorized to access the requested data
                instance: https://akab-1234abcd.luna.akamaiapis.net/siem/v1/configs=123
                method: GET
                requestId: 9cf2274
                requestTime: '2023-06-20T15:01:11Z'
                serverIp: 192.0.2.186
                title: Unauthorized
                type: https://problems.cloudsecurity.akamaiapis.net/siem/v1/unauthorized
              schema:
                additionalProperties: true
                description: Encapsulates debugging information for error responses.
                properties:
                  detail:
                    description: Detail error message.
                    type: string
                  errors:
                    description: Further nested problem objects describing individual errors.
                    items:
                      description: A further-nested problem object.
                      type: object
                      x-akamai:
                        file-path: schemas/problem-nested.yaml
                    type: array
                  instance:
                    description: The non-referenceable URI for the error instance.
                    example: https://problems.luna.akamaiapis.net/siem/error-instances/d54686b5-21cb-4ab7-a8d6-a92282cf1749
                    type: string
                  status:
                    description: HTTP status code.
                    example: 404
                    type: integer
                  title:
                    description: Title for the error.
                    example: Not Found
                    type: string
                  type:
                    description: URL for the error type.
                    example: https://problems.luna.akamaiapis.net/siem/error-types/NOT-FOUND
                    type: string
                required:
                - type
                - title
                type: object
                x-akamai:
                  file-path: schemas/problem.yaml
          description: '[Forbidden](https://techdocs.akamai.com/siem-integration/reference/403). You don''t have permission to view the resource.'
          x-akamai:
            file-path: errors/403.yaml
        '404':
          content:
            application/problem+json:
              example:
                clientIp: 192.0.2.37
                detail: The data for the object requested does not exist
                instance: https://akab-1234abcd.luna.akamaiapis.net/siem/v1/configs=12345?offset=123
                method: GET
                requestId: 9ab12ef
                requestTime: '2023-06-20T15:02:30Z'
                serverIp: 192.0.2.196
                title: Not found
                type: https://problems.cloudsecurity.akamaiapis.net/siem/v1/not-found
              schema:
                additionalProperties: true
                description: Encapsulates debugging information for error responses.
                properties:
                  detail:
                    description: Detail error message.
                    type: string
                  errors:
                    description: Further nested problem objects describing individual errors.
                    items:
                      description: A further-nested problem object.
                      type: object
                      x-akamai:
                        file-path: schemas/problem-nested.yaml
                    type: array
                  instance:
                    description: The non-referenceable URI for the error instance.
                    example: https://problems.luna.akamaiapis.net/siem/error-instances/d54686b5-21cb-4ab7-a8d6-a92282cf1749
                    type: string
                  status:
                    description: HTTP status code.
                    example: 404
                    type: integer
                  title:
                    description: Title for the error.
                    example: Not Found
                    type: string
                  type:
                    description: URL for the error type.
                    example: https://problems.luna.akamaiapis.net/siem/error-types/NOT-FOUND
                    type: string
                required:
                - type
                - title
                type: object
                x-akamai:
                  file-path: schemas/problem.yaml
          description: '[Not found](https://techdocs.akamai.com/siem-integration/reference/404). The resource wasn''t found.'
          x-akamai:
            file-path: errors/404.yaml
        '416':
          content:
            application/problem+json:
              example:
                clientIp: 192.0.2.228
                detail: Expired offset parameter in the request
                instance: https://akab-1234abcd.luna.akamaiapis.net/siem/v1/configs=12345?offset=123
                method: GET
                requestId: 9ab12ef
                requestTime: '2023-06-20T15:02:30Z'
                serverIp: 192.0.2.59
                title: Expired offset parameter in the request
                type: https://problems.cloudsecurity.akamaiapis.net/siem/v1/offset-too-old
              schema:
                additionalProperties: true
                description: Encapsulates debugging information for error responses.
                properties:
                  detail:
                    description: Detail error message.
                    type: string
                  errors:
                    description: Further nested problem objects describing individual errors.
                    items:
                      description: A further-nested problem object.
                      type: object
                      x-akamai:
                        file-path: schemas/problem-nested.yaml
                    type: array
                  instance:
                    description: The non-referenceable URI for the error instance.
                    example: https://problems.luna.akamaiapis.net/siem/error-instances/d54686b5-21cb-4ab7-a8d6-a92282cf1749
                    type: string
                  status:
                    description: HTTP status code.
                    example: 404
                    type: integer
                  title:
                    description: Title for the error.
                    example: Not Found
                    type: string
                  type:
                    description: URL for the error type.
                    example: https://problems.luna.akamaiapis.net/siem/error-types/NOT-FOUND
                    type: string
                required:
                - type
                - title
                type: object
                x-akamai:
                  file-path: schemas/problem.yaml
          description: '[Expired offset parameter in the request](https://techdocs.akamai.com/siem-integration/reference/416).'
          x-akamai:
            file-path: errors/416.yaml
        '429':
          content:
            application/problem+json:
              example:
                clientIp: 192.0.2.130
                detail: Too many requests made from clients of this account
                instance: https://akab-1234abcd.luna.akamaiapis.net/siem/v1/configs=12345?offset=123
                method: GET
                requestId: 9ab12ef
                requestTime: '2023-06-20T15:02:30Z'
                serverIp: 192.0.2.113
                title: Too many requests
                type: https://problems.cloudsecurity.akamaiapis.net/siem/v1/too-many-requests
              schema:
                additionalProperties: true
                description: Encapsulates debugging information for error responses.
                properties:
                  detail:
                    description: Detail error message.
                    type: string
                  errors:
                    description: Further nested problem objects describing individual errors.
                    items:
                      description: A further-nested problem object.
                      type: object
                      x-akamai:
                        file-path: schemas/problem-nested.yaml
                    type: array
                  instance:
                    description: The non-referenceable URI for the error instance.
                    example: https://problems.luna.akamaiapis.net/siem/error-instances/d54686b5-21cb-4ab7-a8d6-a92282cf1749
                    type: string
                  status:
                    description: HTTP status code.
                    example: 404
                    type: integer
                  title:
                    description: Title for the error.
                    example: Not Found
                    type: string
                  type:
                    description: URL for the error type.
                    example: https://problems.luna.akamaiapis.net/siem/error-types/NOT-FOUND
                    type: string
                required:
                - type
                - title
                type: object
                x-akamai:
                  file-path: schemas/problem.yaml
          description: '[Exceeded rate limit](https://techdocs.akamai.com/siem-integration/reference/429). Too many requests.'
          x-akamai:
            file-path: errors/429.yaml
        '500':
          content:
            application/problem+json:
              example:
                clientIp: 192.0.2.201
                detail: Internal server error
                instance: https://akab-1234abcd.luna.akamaiapis.net/siem/v1/configs=12345?offset=123
                method: GET
                requestId: 9ab12ef
                requestTime: '2023-06-20T15:02:30Z'
                serverIp: 192.0.2.221
                title: Error
                type: https://problems.cloudsecurity.akamaiapis.net/siem/v1/error
              schema:
                additionalProperties: true
                description: Encapsulates debugging information for error responses.
                properties:
                  detail:
                    description: Detail error message.
                    type: string
                  errors:
                    description: Further nested problem objects describing individual errors.
                    items:
                      description: A further-nested problem object.
                      type: object
                      x-akamai:
                        file-path: schemas/problem-nested.yaml
                    type: array
                  instance:
                    description: The non-referenceable URI for the error instance.
                    example: https://problems.luna.akamaiapis.net/siem/error-instances/d54686b5-21cb-4ab7-a8d6-a92282cf1749
                    type: string
                  status:
                    description: HTTP status code.
                    example: 404
                    type: integer
                  title:
                    description: Title for the error.
                    example: Not Found
                    type: string
                  type:
                    description: URL for the error type.
                    example: https://problems.luna.akamaiapis.net/siem/error-types/NOT-FOUND
                    type: string
                required:
                - type
                - title
                type: object
                x-akamai:
                  file-path: schemas/problem.yaml
          description: '[Any other server error](https://techdocs.akamai.com/siem-integration/reference/500).'
          x-akamai:
            file-path: errors/500.yaml
        '503':
          content:
            application/problem+json:
              example:
                clientIp: 192.0.2.20
                detail: There is no available backend system to respond to the request
                instance: https://akab-1234abcd.luna.akamaiapis.net/siem/v1/configs=12345?offset=123
                method: GET
                requestId: 9ab12ef
                requestTime: '2023-06-20T15:02:30Z'
                serverIp: 192.0.2.39
                title: Service unavailable
                type: https://problems.cloudsecurity.akamaiapis.net/siem/v1/service-unavailable
              schema:
                additionalProperties: true
                description: Encapsulates debugging information for error responses.
                properties:
                  detail:
                    description: Detail error message.
                    type: string
                  errors:
                    description: Further nested problem objects describing individual errors.
                    items:
                      description: A further-nested problem object.
                      type: object
                      x-akamai:
                        file-path: schemas/problem-nested.yaml
                    type: array
                  instance:
                    description: The non-referenceable URI for the error instance.
                    example: https://problems.luna.akamaiapis.net/siem/error-instances/d54686b5-21cb-4ab7-a8d6-a92282cf1749
                    type: string
                  status:
                    description: HTTP status code.
                    example: 404
                    type: integer
                  title:
                    description: Title for the error.
                    example: Not Found
                    type: string
                  type:
                    description: URL for the error type.
                    example: https://problems.luna.akamaiapis.net/siem/error-types/NOT-FOUND
                    type: string
                required:
                - type
                - title
                type: object
                x-akamai:
                  file-path: schemas/problem.yaml
          description: '[Service unavailable](https://techdocs.akamai.com/siem-integration/reference/503).'
          x-akamai:
            file-path: errors/503.yaml
      summary: Fetch security events
      tags:
      - Events
      x-akamai:
        supports-account-switch-key: false
externalDocs:
  description: See documentation for Akamai's API Endpoint Definition API
  url: https://techdocs.akamai.com/api-definitions/reference
x-readme:
  samples-languages:
  - curl
  - python
  - node