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

> ## 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 addresses

Get/v2.3/objects/addresses

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

SecurityHTTPType bearer

Responses200

Completed successfully

<select class='api-response-data' aria-label='Media type'><option value='d4a169e7-687a-4275-9fd5-46b718df1af9'>application/json</option>
</select>Expand Allobject  data Array of object (ObjectsAddressObj)   object  idstring    

Unique Address ID

namestring    

The name of the Objects

Min length3Max length100Pattern^[a-zA-Z0-9_ ]+$
descriptionstring    
OneOfObjectsAddressIPobject (ObjectsAddressIP)valueTypestring    Valid values[
  "ip"
]
value Array of string (IP)   Min items1Max items1string  (ipv4)    

ObjectsAddressIPListobject (ObjectsAddressIPList)valueTypestring    Valid values[
  "list"
]
value Array of string (IP)   

Must be a unique list of IPs

Min items1string  (ipv4)    

ObjectsAddressCIDRobject (ObjectsAddressCIDR)valueTypestring    Valid values[
  "cidr"
]
value Array of string (CIDR)   Min items1Max items1string    Pattern^((?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3})(\/(3[0-2]|[1-2][0-9]|[0-9]))$

ObjectsAddressFQDNobject (ObjectsAddressFQDN)valueTypestring    Valid values[
  "fqdn"
]
value Array of string (FQDN)   Min items1Max items1string    Pattern(?=^.{4,253}$)(^((?!-)[a-zA-Z0-9-]{0,62}[a-zA-Z0-9]\.)+[a-zA-Z]{2,63}$)

pagenumber    Minimum0Maximum500
totalPagenumber    Minimum0Maximum500
itemsTotalnumber    Minimum0Maximum500

401

Unauthorized

403

Forbidden