---
title: "Get all SNMP trap mappings"
method: GET
path: "/v1/snmp-trap-mappings"
tags: ["SNMP Trap Mappings"]
---

# Get all SNMP trap mappings

`GET /v1/snmp-trap-mappings`

Retrieve all SNMP trap to event mappings. Requires CONFIGURE_TRAPS system access right.

## Response `200`

List of SNMP trap mappings.

- SnmpTrapMapping[]
  - `id` integer — SNMP trap mapping ID.
  - `guid` string, uuid — SNMP trap mapping GUID.
  - `oid` string — Trap OID. Traps are matched by exact OID or by longest matching OID prefix.
  - `eventCode` integer — Code of the event generated for matching trap.
  - `eventTag` string, nullable — Tag added to generated event.
  - `description` string — Trap mapping description.
  - `transformationScript` string — NXSL transformation script source.
  - `parameters` SnmpTrapParameterMapping[] — Parameter mappings (omitted if there are none).
    - `id` integer — Parameter number (1-based position in the parameter list). Ignored on input.
    - `oid` string — OID of the varbind (for mapping by OID).
    - `position` integer — Varbind position (for mapping by position). Takes precedence over `oid` when positive.
    - `description` string — Parameter description.
    - `flags` integer — Parameter mapping flags (bit 0 - force text representation of value).

## Other responses

- `401` — Unauthorized.
- `403` — Access denied.

## Changes

- **2026-09-30** `d3ebef46a35c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/snmp-trap-mappings/get.md)

---

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