---
title: "Get object services"
slug: "get-object-services"
updated: 2026-02-18T12:52:40Z
published: 2026-02-18T12:52:58Z
canonical: "support.perimeter81.com/get-object-services"
---

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

# Get object services

Get/v2.3/objects/services

Required permissions: `["objects:read"]`.

SecurityHTTPType bearer

Responses200

Completed successfully

<select class='api-response-data' aria-label='Media type'><option value='0d51aa65-82dc-44fe-8ed0-a518daf109bf'>application/json</option>
</select>Expand Allobject  data Array of object (ObjectsServicesResponseObj)   object  namestring    

The name of the Objects

Min length3Max length100Pattern^[a-zA-Z0-9_ ]+$
descriptionstring    
protocols Array of object (ObjectsServicesProtocolResponseObj)   AnyOfObjectServiceProtocolTCPUDPobject (ObjectServiceProtocolTCPUDP)protocolstring    Valid values[
  "tcp",
  "udp"
]
OneOfObjectServiceProtocolSingleobject (ObjectServiceProtocolSingle)valueTypestring    Valid values[
  "single"
]
value Array of integer (PortNumber)   Min items1Max items1integer    Minimum1Maximum65535

ObjectServiceProtocolRangeobject (ObjectServiceProtocolRange)valueTypestring    Valid values[
  "range"
]
value Array of integer (PortNumber)   Min items2Max items2integer    Minimum1Maximum65535

ObjectServiceProtocolListobject (ObjectServiceProtocolList)valueTypestring    Valid values[
  "list"
]
value Array of integer (PortNumber)   Min items1integer    Minimum1Maximum65535

ObjectServiceProtocolICMPResponseobject (ObjectServiceProtocolICMPResponse)protocolstring    Valid values[
  "icmp"
]
protocolOptionsobject (ObjectServiceProtocolOptionsICMPresponse)  

-1 means 'any', the rest of the values are the RFC default ICMP parameters

Valid values[
  {
    "code": -1,
    "description": "Any"
  },
  {
    "code": 0,
    "description": "Echo Reply"
  },
  {
    "code": 3,
    "description": "Destination Unreachable"
  },
  {
    "code": 5,
    "description": "Redirect"
  },
  {
    "code": 8,
    "description": "Echo"
  },
  {
    "code": 9,
    "description": "Router Advertisement"
  },
  {
    "code": 10,
    "description": "Router Selection"
  },
  {
    "code": 11,
    "description": "Time Exceeded"
  },
  {
    "code": 12,
    "description": "Parameter Problem"
  },
  {
    "code": 13,
    "description": "Timestamp"
  },
  {
    "code": 14,
    "description": "Timestamp Reply"
  },
  {
    "code": 40,
    "description": "Photuris"
  },
  {
    "code": 42,
    "description": "Extended Echo Request"
  },
  {
    "code": 43,
    "description": "Extended Echo Reply"
  }
]codeinteger    
descriptionstring    

pagenumber    Minimum0Maximum500
totalPagenumber    Minimum0Maximum500
itemsTotalnumber    Minimum0Maximum500

401

Unauthorized

403

Forbidden