---
title: "Get a notice"
method: GET
path: "/notices/{uuid}"
tags: ["Notices"]
---

# Get a notice

`GET /notices/{uuid}`

## Request

- Base URL: `https://app.honeybadger.io/v3`
- URL: `https://app.honeybadger.io/v3/notices/{uuid}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/honeybadger/apis/honeybadger-api/docs/notices/:uuid/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a notice by its ID, without its project or fault in the path.

## Path parameters

- `uuid` string, uuid, required

## Query parameters

- `unmapped` boolean

## Response `200`

Success

- object
  - `data` Notice, required: An individual error occurrence
    - `id` string, uuid, required: The notice's ID, a UUID that addresses it without its project or fault
    - `fault_id` string, required: ID of the fault this notice belongs to
    - `project_id` string, required: ID of the project
    - `environment` string, nullable: Environment name: the fault's environment, or the one the notice reported when the fault has none. Null when neither is set.
    - `message` string, nullable, required: Error message. Null when the notifier reported none.
    - `created_at` string, date-time, required: When the notice was received
    - `request` object, nullable: Request details when the error occurred. Fields not reported are null.
      - `url` string, nullable: Request URL
      - `component` string, nullable: Controller or component name
      - `action` string, nullable: Action name
      - `params` object, nullable: Request parameters
      - `session` object, nullable: Session data
    - `context` object: Custom context data sent with the notice
    - `backtrace` NoticeFrame[]: Stack trace frames, at most 20. Source-mapped by default; pass `unmapped=true` for the frames exactly as the client sent them.
      - `file` string, nullable: Path to the source file. Null when the notifier sent a backtrace entry that carried no file, or one that was not a frame at all.
      - `line` integer, nullable: Line number within `file`. Null when the notifier sent a value that is not a line number, such as `(eval)`.
      - `column` integer, nullable: Column number. Usually present only on source-mapped frames.
      - `method` string, nullable: Name of the method or function. Null when the notifier omitted it, and routinely on source-mapped frames where the map carries no name for the position.
      - `in_app` boolean: Whether this frame is the project's own code rather than a framework, gem or dependency. Derived from the project root the notifier reported.
      - `mapping` 'source_mapped' | 'reported': Whether this specific frame was resolved through a source map. Mapping is applied one frame at a time and falls back to the reported frame, so a source-mapped trace can contain reported frames. Always `reported` when `unmapped=true` was requested.
      - `source` SourceBlock[]: Contiguous runs of source lines around the frame. Normally one block; a notifier-sent snippet with a gap produces one block per run. Empty when no source is available, when the notifier sent it in a shape other than a map of line number to content, or when no entry carried a usable line number. At most 25 lines in total.
        - `first_line` integer, required: Line number of the first entry in `lines`.
        - `lines` string[], required: Source lines in order. Each line is truncated to 1024 characters. Across all of a frame's blocks at most 25 lines are returned, chosen nearest the frame's own line so that line is always present when the notifier sent it.
    - `backtrace_mode` 'source_mapped' | 'reported': Which representation of the trace this response carries. `source_mapped` when a stored mapped trace was served, `reported` when the frames are as the client sent them — either because `unmapped=true` was requested or because no different mapped trace was stored.
    - `backtrace_total_frames` integer: Total frames in the selected trace before the 20-frame limit was applied.
    - `backtrace_truncated` boolean: Whether `backtrace` omits frames because of the 20-frame limit.
    - `request_fields_removed` string[], nullable: Names of `request` fields removed at ingest because the payload exceeded the size limit. Null when nothing was removed.
    - `links` WebLinks: Links into the Honeybadger web UI
      - `web` string, uri, required: The resource's page in the Honeybadger web UI, as an absolute URL. Resources without a page, such as outages and deploys, don't have `links`. For a project provisioned through Heroku, error, notice and comment links go through Heroku's single sign-on.
  - `meta` ResponseMeta
    - `request_id` string: Unique identifier for the request, for correlating with support

## Other responses

- `400`: A query parameter is malformed or outside its allowed values. `error.details` names the parameter.
- `401`: The credential is missing, invalid, expired or revoked (`unauthorized`), or was sent in a way v3 doesn't accept (see the examples).
- `403`: The credential isn't allowed to do this. `error.code` says why. An account or project the credential doesn't cover is 404 `not_found`, not 403.
- `404`: Resource not found
- `422`: No path names the account, so the API token has to. This is returned when the token covers more than one account and the account a request applies to cannot be determined. Use a token bound to a single account.

---

[API](https://skmtc.dev/honeybadger/apis/honeybadger-api.md) - [All operations](https://skmtc.dev/honeybadger/apis/honeybadger-api/llms.txt) - [OpenAPI document](https://skmtc.dev/honeybadger/apis/honeybadger-api/revisions/cbcff53f2c8a?raw)