---
title: "Get a specific Ringfence Rule."
slug: "get-a-specific-ringfence-rule-1"
updated: 2026-03-02T22:30:52Z
published: 2026-03-02T22:35:48Z
canonical: "support.appgate.com/get-a-specific-ringfence-rule-1"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.appgate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a specific Ringfence Rule.

Get/ringfence-rules/{id}

Get a specific Ringfence Rule.

SecurityHTTPType bearer

Path parametersidstring (uuid) Required

ID of the object.

Example12699e27-b584-464a-81ee-5b4784b6d425

Responses200

Single Ringfence Rule object.

<select class='api-response-data' aria-label='Media type'><option value='27b0cb3f-222d-48d8-9d6a-0101cd5adb8d'>application/json</option>
</select>Expand Allobject  idstring  (uuid)    

ID of the object.

Example4c07bc67-57ea-42dd-b702-c2d6c45419fc
namestring    

Name of the object.

Exampleobject
notesstring    

Notes for the object. Used for documentation purposes.

ExampleThis object has been created for test purposes.
createdstring  (date-time)    

Create date.

updatedstring  (date-time)    

Last update date.

tags Array of string   

Array of tags.

Example[
  "developer",
  "api-created"
]string    
actions Array of object   

List of all ringfence actions in this Ringfence Rule.

object  protocolstring    

Protocol of the ringfence action.

Valid values[
  "icmp",
  "icmpv6",
  "udp",
  "tcp"
]
directionstring    

The direction of the action

Valid values[
  "up",
  "down",
  "out",
  "in"
]
actionstring    

Applied action to the traffic.

Valid values[
  "allow",
  "block"
]
hosts Array of string   

Destination address. IP address or hostname.

string    Example10.0.2.0/24
ports Array of string   

Destination port. Multiple ports can be entered comma separated. Port ranges can be entered dash separated. Only valid for tcp and udp subtypes.

Example[
  "80",
  "443",
  "1024-2048"
]string    
types Array of string   

ICMP type. Only valid for icmp protocol.

string    Example0-255

401

Token error. Login again.

<select class='api-response-data' aria-label='Media type'><option value='f0a7d78d-6b57-425e-b9bd-aeca9cb4cec9'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

403

Insufficient permissions to access this resource.

<select class='api-response-data' aria-label='Media type'><option value='aff66609-4037-4b33-8a83-0aa210e1e65e'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

404

The requested resource can not be found.

<select class='api-response-data' aria-label='Media type'><option value='78e9b2a0-28bb-4547-9259-9246f8500453'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

406

Invalid 'Accept' header.

<select class='api-response-data' aria-label='Media type'><option value='f7b94004-7de9-4a53-806b-c0a137e0f838'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

500

Unexpected server side error.

<select class='api-response-data' aria-label='Media type'><option value='949f2750-7d09-42ab-86ce-86681eaa9278'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.