---
title: "Firewall assignments"
method: GET
path: "/firewalls/{firewall_id}/assignments"
tags: ["Firewalls"]
---

# Firewall assignments

`GET /firewalls/{firewall_id}/assignments`

## Request

- Base URL: `https://api.latitude.sh`
- URL: `https://api.latitude.sh/firewalls/{firewall_id}/assignments`
- Auth: API key in header `Authorization`

Returns a list of all servers and virtual machines assigned to a particular firewall.

## Path parameters

- `firewall_id` string, required

## Query parameters

- `page[size]` integer
- `page[number]` integer

## Response `200`

Success

## Changes

- **2026-08-19** `9545f24e8507`: 1 breaking, 1 info
  - the response property `data/items/attributes/server/primary_ipv4` became nullable for the status `200`
  - added the optional property `data/items/attributes/virtual_machine` to the response with the `200` status

[Operation history](https://skmtc.dev/latitude/apis/latitude-sh-api/changes/firewalls/:firewall_id/assignments/get.md)

---

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