List nodes
Returns a paginated list of Wings nodes registered on the panel.
/api/application/nodesAuthorization
default Application API requests require an application API token, or a client API token, that belongs to a root administrator. Admin API requests require a client API token that belongs to a root administrator, and reject application API tokens. Client API requests require a client API token.
In: header
Query Parameters
Number of nodes to return per page, up to 100.
Filter nodes by UUID.
Filter nodes by name.
Filter nodes by fully qualified domain name.
Filter nodes by daemon token identifier.
Sort nodes by id, uuid, memory, or disk. Prefix with "-" for descending order.
Value in
- "id"
- "-id"
- "uuid"
- "-uuid"
- "memory"
- "-memory"
- "disk"
- "-disk"
Comma-separated relationships to include. Supports "allocations", "location", and "servers" when the key can read those resources.
Value in
- "allocations"
- "location"
- "servers"
- "location,allocations"
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/api/application/nodes?per_page=50&filter%5Buuid%5D=3d8dd7f9-07a1-4d65-8db0-8c8921f2f4f7&filter%5Bname%5D=Node+1&filter%5Bfqdn%5D=node.example.com&filter%5Bdaemon_token_id%5D=abcdefghijklmnop&sort=-id&include=location%2Callocations"{ "object": "list", "data": [ { "object": "node", "attributes": { "id": 13316, "uuid": "187b8d09-e808-4cfb-83d2-99913dff8daa", "public": true, "name": "FactoryNode_z0EUCKodf8", "description": "string", "location_id": 15978, "fqdn": "17.170.141.175", "scheme": "http", "behind_proxy": false, "maintenance_mode": false, "memory": 1024, "memory_overallocate": 0, "disk": 10240, "disk_overallocate": 0, "upload_size": 100, "daemon_listen": 8080, "daemon_sftp": 2022, "daemon_base": "/var/lib/pterodactyl/volumes", "created_at": "2026-09-22T14:45:23+00:00", "updated_at": "2026-09-22T14:45:23+00:00", "allocated_resources": { "memory": 0, "disk": 0 } }, "meta": { "resource": "https://panel.example.test/api/application/nodes/1" } } ], "meta": { "pagination": { "total": 1, "count": 1, "per_page": 50, "current_page": 1, "total_pages": 1, "links": { "property1": "string", "property2": "string" } } }}