Syslog Forwarders Get By Id
Retrieves full configuration profile and telemetry statistics for a specific Syslog forwarder. Accessible to ADMIN, SECURITY_OPERATOR, and AUDITOR.
Syslog Forwarder canonical identifier
1
200 OK successful response envelope. The forwarder profile with its delivery statistics
{
"forwarderId": 1,
"name": "Primary SIEM",
"description": "Security operations syslog collector",
"isEnabled": true,
"host": "siem.example.com",
"port": 6514,
"protocol": "TLS",
"format": "RFC5424_ICDX",
"recordScope": "SECURITY_AND_AUDIT",
"tlsVerifyPeer": true,
"clientCertId": null,
"customCaCertId": null,
"customCaSubject": null,
"customCaFingerprintSha256": null,
"customCaNotAfter": null,
"batchSize": 75000,
"connectTimeoutMs": 3000,
"version": 2,
"lastTestAt": "2026-01-15T09:40:00Z",
"lastTestStatus": "PASSED",
"lastErrorMessage": null,
"lastSuccessAt": "2026-01-15T10:15:00Z",
"eventsForwarded": 1284,
"bytesForwarded": 913408
}
Unique canonical identifier for the forwarder
Human-readable forwarder profile name
Optional narrative description
Whether this forwarding destination is actively processing events
Target destination IP address or fully qualified domain name
Destination network port (1-65535)
Transport protocol for Syslog transmission
TCP: A plain TCP connection with RFC 5425 octet-counting framing; the defaultUDP: One datagram per message, clamped to 2,048 bytesTLS: A TCP connection upgraded to TLS with the same octet-counting framing; the peer certificate chain and host name are verified unless the destination sets tlsVerifyPeer to false
Wire-format framing and serialization format
RFC5424_ICDX: RFC 5424 frames whose body is a compact ICDX JSON document; the defaultRFC5424_STANDARD: Plain RFC 5424 syslog framesCEF: Common Event Format lines (CEF:0 with vendor Broadcom and product HyperArmor)
Stream selection - which unfiltered streams this destination receives. The request field is typed with the server's own enum, which also accepts ALERT, SECURITY_AND_ALERT, AUDIT_AND_ALERT and ALL (alert records included); this list does not show them
SECURITY: Security events onlyAUDIT: Audit records onlySECURITY_AND_AUDIT: Security events and audit records; the default for a new destination
Whether to verify remote TLS certificate
Appliance client certificate ID for mutual TLS
Custom CA certificate ID for private PKI trust
Subject of the destination's private CA certificate (first certificate of the pasted bundle); absent when none is configured
SHA-256 fingerprint of the private CA certificate, colon-separated upper-case hex; absent when none is configured
Expiry of the private CA certificate; absent when none is configured
Configured batch size for keyset read (100 - 100000)
TCP/TLS connect timeout in milliseconds (500 - 30000)
Optimistic-concurrency version token
Timestamp of last reachability test
Operational connectivity test status
PASSED: The last connectivity test to the destination succeededFAILED: The last connectivity test to the destination failedNEVER_TESTED: No connectivity test has run for the destination; the status of a newly created destination
Last error message recorded during forwarding or testing
Timestamp of last successful event delivery
Total lifetime forwarded event count
Total lifetime forwarded payload bytes
400 Bad Request: INVALID_ARGUMENT when the id path variable is not a number
{
"errorCode": "string",
"message": "string",
"path": "string",
"timestamp": "string",
"reason": "string"
}
Stable machine-readable error code. The known values are listed in ApiErrorCode; the set is not closed, so a client must tolerate an unlisted value.
Human-readable error description
Request URI path that produced the error
Timestamp when the error occurred as an ISO 8601 date-time with offset
A finer code, present only where an endpoint documents it. The Rule Pack endpoints' PACK_ENTRY_INVALID carries the import core's code here.
401 Unauthorized: UNAUTHENTICATED when the VTP_SESSION cookie is missing, unknown, expired or revoked
{
"errorCode": "string",
"message": "string",
"path": "string",
"timestamp": "string",
"reason": "string"
}
Stable machine-readable error code. The known values are listed in ApiErrorCode; the set is not closed, so a client must tolerate an unlisted value.
Human-readable error description
Request URI path that produced the error
Timestamp when the error occurred as an ISO 8601 date-time with offset
A finer code, present only where an endpoint documents it. The Rule Pack endpoints' PACK_ENTRY_INVALID carries the import core's code here.
403 Forbidden: PASSWORD_CHANGE_REQUIRED when the account must change its password first (only GET /api/v1/auth/session, POST /api/v1/auth/logout and POST /api/v1/auth/change-password are exempt); LICENSE_REQUIRED or LICENSE_EXPIRED while the license pool is restricted (no license, or expired past grace) (exempt: every route under /api/v1/auth, GET /api/v1/user/preferences, GET /api/v1/licensing/summary and POST /api/v1/licensing/licenses)
{
"errorCode": "string",
"message": "string",
"path": "string",
"timestamp": "string",
"reason": "string"
}
Stable machine-readable error code. The known values are listed in ApiErrorCode; the set is not closed, so a client must tolerate an unlisted value.
Human-readable error description
Request URI path that produced the error
Timestamp when the error occurred as an ISO 8601 date-time with offset
A finer code, present only where an endpoint documents it. The Rule Pack endpoints' PACK_ENTRY_INVALID carries the import core's code here.
404 Not Found: FORWARDER_NOT_FOUND when no forwarder has the id
"ApiErrorResponse Object"
Stable machine-readable error code. The known values are listed in ApiErrorCode; the set is not closed, so a client must tolerate an unlisted value.
Human-readable error description
Request URI path that produced the error
Timestamp when the error occurred as an ISO 8601 date-time with offset
A finer code, present only where an endpoint documents it. The Rule Pack endpoints' PACK_ENTRY_INVALID carries the import core's code here.
curl -H 'Authorization: <value>' https://{api_host}/api/v1/syslog-forwarders/{id}