Bugsnag

bugsnag Events API

Access individual error events. Events represent individual occurrences of an error within a project.

GitHub OpenAPI
Business capability
Observability Management BC-4220.20

Operations 3

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /projects/{project_id}/errors/{error_id}/events List occurrences of an error · List error events #
Ask an LLM
“How can I see every individual occurrence of an error?”
“Can I page through the events recorded for one error?”
Tell an agent
List the events for error {error_id} in project {project_id}.
Show {per_page} occurrences per page of error {error_id} in project {project_id}.
GET /projects/{project_id}/errors/{error_id}/events/latest Get the most recent occurrence of an error · Get the latest event for an error #
Ask an LLM
“What did the most recent occurrence of this error look like?”
“Can I get the device info and stack trace from the last time an error happened?”
Tell an agent
Get the latest event for error {error_id} in project {project_id}.
Show the newest stack trace for error {error_id} in project {project_id}.
GET /projects/{project_id}/events/{event_id} Get a specific event by ID · Get an event #
Ask an LLM
“How do I pull the full details of one event I have the ID for?”
“Does a single event include custom metadata and app state?”
Tell an agent
Show event {event_id} in project {project_id}.
Get the stack trace and device data for event {event_id} in project {project_id}.

Documentation

📖
Documentation
https://developer.smartbear.com/bugsnag/docs/data-access
📖
APIReference
https://developer.smartbear.com/bugsnag

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/bugsnag/refs/heads/main/openapi/bugsnag-events-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/bugsnag:bugsnag-events-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

bugsnag-events-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Bugsnag Data Access Events API
  description: The Bugsnag Data Access API provides programmatic access to information about your organization, projects, errors, events, and more. It allows developers to build custom integrations and dashboards using their Bugsnag data. The REST API uses JSON and requires authentication via a personal auth token sent in the Authorization header. It supports querying error trends, project configurations, collaborators, and release information.
  version: '2.0'
  contact:
    name: Bugsnag Support
    url: https://docs.bugsnag.com/api/data-access/
  termsOfService: https://smartbear.com/terms-of-use/
servers:
- url: https://api.bugsnag.com
  description: Bugsnag Production API Server
security:
- tokenAuth: []
tags:
- name: Events
  description: Access individual error events. Events represent individual occurrences of an error within a project.
paths:
  /projects/{project_id}/errors/{error_id}/events:
    get:
      operationId: listErrorEvents
      summary: List error events
      description: Returns a list of events for the specified error. Events represent individual occurrences of an error. Results are paginated.
      tags:
      - Events
      parameters:
      - $ref: '#/components/parameters/ProjectId'
      - $ref: '#/components/parameters/ErrorId'
      - $ref: '#/components/parameters/PerPage'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Event'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Error not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /projects/{project_id}/errors/{error_id}/events/latest:
    get:
      operationId: getLatestEvent
      summary: Get the latest event for an error
      description: Returns the most recent event for the specified error, including full exception details, device information, and metadata.
      tags:
      - Events
      parameters:
      - $ref: '#/components/parameters/ProjectId'
      - $ref: '#/components/parameters/ErrorId'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Event'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Error not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /projects/{project_id}/events/{event_id}:
    get:
      operationId: getEvent
      summary: Get an event
      description: Returns the full details of a specific event, including exception information, stack traces, device data, application state, and any custom metadata attached to the event.
      tags:
      - Events
      parameters:
      - $ref: '#/components/parameters/ProjectId'
      - $ref: '#/components/parameters/EventId'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Event'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Event not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    StackFrame:
      type: object
      description: Represents a single frame in a stack trace.
      properties:
        file:
          type: string
          description: The file path where the frame originated.
        line_number:
          type: integer
          description: The line number in the file.
        column_number:
          type: integer
          description: The column number in the file.
        method:
          type: string
          description: The method or function name.
        in_project:
          type: boolean
          description: Whether this frame is from the project's own code.
        code:
          type: object
          additionalProperties:
            type: string
          description: A map of line numbers to code content around the error.
    Exception:
      type: object
      description: Represents an exception within an error event, including the error class, message, and stack trace.
      properties:
        error_class:
          type: string
          description: The class or type of the exception.
        message:
          type: string
          description: The exception message.
        stacktrace:
          type: array
          description: The stack trace frames for this exception.
          items:
            $ref: '#/components/schemas/StackFrame'
    Event:
      type: object
      description: Represents an individual error occurrence, containing full exception details, stack traces, device information, and metadata.
      properties:
        id:
          type: string
          description: The unique identifier of the event.
        error_id:
          type: string
          description: The identifier of the error group this event belongs to.
        project_id:
          type: string
          description: The identifier of the project this event belongs to.
        error_class:
          type: string
          description: The class or type of the error.
        message:
          type: string
          description: The error message for this event.
        context:
          type: string
          description: The context in which the error occurred.
        severity:
          type: string
          enum:
          - error
          - warning
          - info
          description: The severity level of this event.
        user:
          type: object
          description: Information about the user who experienced the error.
          properties:
            id:
              type: string
              description: The user's identifier.
            name:
              type: string
              description: The user's name.
            email:
              type: string
              format: email
              description: The user's email address.
        app:
          type: object
          description: Information about the application where the error occurred.
          properties:
            version:
              type: string
              description: The application version.
            release_stage:
              type: string
              description: The release stage (e.g., production, staging).
        device:
          type: object
          description: Information about the device where the error occurred.
          properties:
            hostname:
              type: string
              description: The hostname of the device.
            os_name:
              type: string
              description: The operating system name.
            os_version:
              type: string
              description: The operating system version.
            browser_name:
              type: string
              description: The browser name, if applicable.
            browser_version:
              type: string
              description: The browser version, if applicable.
        exceptions:
          type: array
          description: The list of exceptions in this event.
          items:
            $ref: '#/components/schemas/Exception'
        breadcrumbs:
          type: array
          description: The breadcrumb trail leading up to the error.
          items:
            $ref: '#/components/schemas/Breadcrumb'
        request:
          type: object
          description: Information about the HTTP request during which the error occurred.
          properties:
            url:
              type: string
              format: uri
              description: The URL of the request.
            http_method:
              type: string
              description: The HTTP method of the request.
            referer:
              type: string
              description: The referer header value.
            client_ip:
              type: string
              description: The client's IP address.
        meta_data:
          type: object
          additionalProperties: true
          description: Custom metadata attached to the event.
        received_at:
          type: string
          format: date-time
          description: The date and time the event was received by Bugsnag.
        url:
          type: string
          format: uri
          description: The API URL for this event resource.
        html_url:
          type: string
          format: uri
          description: The URL to the event on the Bugsnag dashboard.
    Error:
      type: object
      description: An API error response.
      properties:
        errors:
          type: array
          items:
            type: string
          description: List of error messages.
    Breadcrumb:
      type: object
      description: Represents a breadcrumb event that occurred before the error.
      properties:
        timestamp:
          type: string
          format: date-time
          description: The time the breadcrumb was recorded.
        name:
          type: string
          description: The name or title of the breadcrumb event.
        type:
          type: string
          enum:
          - navigation
          - request
          - process
          - log
          - user
          - state
          - error
          - manual
          description: The type of breadcrumb event.
        meta_data:
          type: object
          additionalProperties: true
          description: Additional metadata associated with the breadcrumb.
  parameters:
    EventId:
      name: event_id
      in: path
      required: true
      description: The unique identifier of the event.
      schema:
        type: string
    ProjectId:
      name: project_id
      in: path
      required: true
      description: The unique identifier of the project.
      schema:
        type: string
    PerPage:
      name: per_page
      in: query
      description: The number of results to return per page. Used for pagination.
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 30
    ErrorId:
      name: error_id
      in: path
      required: true
      description: The unique identifier of the error.
      schema:
        type: string
  securitySchemes:
    tokenAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Personal auth token sent as "token YOUR-AUTH-TOKEN". The token can be found in the Bugsnag account settings under the API section.
externalDocs:
  description: Bugsnag Data Access API Documentation
  url: https://docs.bugsnag.com/api/data-access/