> ## Documentation Index > Fetch the complete documentation index at: https://docs.storiza.store/llms.txt > Use this file to discover all available pages before exploring further. # List nodes > The nodes an app can be placed on, with their location and measured capacity. Any signed-in user may read this — picking a node is part of creating an app. Connection details (address, SSH port and user) are never included; customers reach a node at its `fqdn`. Only nodes that are ready and accepting apps are listed. **Required API key permission:** `apps:read` ## OpenAPI ````yaml /openapi.json get /apps-nodes/ openapi: 3.0.0 info: title: Storiza API version: '1.0' description: Manage Storiza servers, apps and subscriptions programmatically. servers: - url: https://api.storiza.store security: - bearerAuth: [] tags: - name: Servers description: Create, order, renew and upgrade VPS servers, and read their details. - name: Server power & commands description: >- Start, stop, reboot and force-stop a server, check its status and run commands on it. - name: Server settings description: >- Rename a server, reinstall its operating system and follow its installation. - name: Server firewall description: Turn a server's firewall on or off and manage its rules. - name: Server metrics description: CPU, memory, disk and network usage, now and over time. - name: Server backups description: Order the backup add-on, and take, list and delete backups. - name: Server snapshots description: Take, list and delete snapshots of a server. - name: Server sharing description: A share link that lets someone else open the server. - name: Server catalog description: >- Plans, operating systems, categories, datacenters and backup plans. Public — no key needed. - name: Apps description: >- Deploy, order, renew and configure apps — game servers, databases and bots. - name: App lifecycle & console description: >- Start, stop, restart and kill an app, read its output and metrics, and send it commands. - name: App files description: >- Read, write, move and delete the files in an app's volume, and its SFTP access. - name: App backups description: Back up an app, download a backup, and restore from one. - name: App domains description: Your own domains for an app, and their DNS verification. - name: App groups description: Private networks that let your apps reach each other by hostname. - name: App catalog description: Templates, plans and locations for apps. - name: Subscriptions description: What you pay for, how often it renews, and stopping or resuming it. - name: Payments description: >- Follow a payment after an order, and the methods and currencies you can pay with. - name: Account description: Your profile, and a summary of everything you own. - name: SSH keys description: Public keys you can install on new Linux servers. paths: /apps-nodes/: get: tags: - App catalog summary: List nodes description: >- The nodes an app can be placed on, with their location and measured capacity. Any signed-in user may read this — picking a node is part of creating an app. Connection details (address, SSH port and user) are never included; customers reach a node at its `fqdn`. Only nodes that are ready and accepting apps are listed. **Required API key permission:** `apps:read` parameters: - schema: type: string required: false name: _sort_by in: query - schema: type: number minimum: 1 default: 1 required: false name: _page in: query - schema: type: number minimum: 1 maximum: 250 default: 10 required: false name: _limit in: query - schema: type: string required: false name: _search in: query - schema: type: string required: false name: id in: query - schema: type: string required: false name: name in: query - schema: type: string required: false name: slug in: query - schema: type: string required: false name: city in: query - schema: type: string required: false name: countryCode in: query - schema: type: string required: false name: region in: query - schema: type: string required: false name: createdAt in: query responses: '200': description: Nodes content: application/json: schema: type: object properties: success: type: boolean enum: - true message: type: string enum: - Nodes data: type: array items: allOf: - $ref: '#/components/schemas/AppNode' - properties: {} pagination: type: object properties: page: type: integer minimum: 1 limit: type: integer minimum: 1 offset: type: integer minimum: 0 total: type: integer minimum: 0 totalPages: type: integer minimum: 1 required: - page - limit - offset - total - totalPages required: - success - message - data - pagination '401': description: Authentication required | Invalid API key | API key has expired content: application/json: schema: type: object properties: success: type: boolean enum: - false type: type: string code: type: string error: type: string details: nullable: true required: - success - type - code - error examples: authenticationRequired: summary: Authentication required value: success: false type: API code: AUTHENTICATION_ERROR error: Authentication required invalidApiKey: summary: Invalid API key value: success: false type: API code: INVALID_API_KEY error: Invalid API key expiredApiKey: summary: API key has expired value: success: false type: API code: EXPIRED_API_KEY error: API key has expired '403': description: >- Account is banned | Account is suspended | Insufficient permissions | This endpoint cannot be accessed with this authentication method | API key lacks the permission required for this endpoint | This API key is not permitted from your IP address content: application/json: schema: type: object properties: success: type: boolean enum: - false type: type: string code: type: string error: type: string details: nullable: true required: - success - type - code - error examples: accountBanned: summary: Account is banned value: success: false type: API code: ACCOUNT_BANNED error: Account is banned accountSuspended: summary: Account is suspended value: success: false type: API code: ACCOUNT_SUSPENDED error: Account is suspended insufficientPermissions: summary: Insufficient permissions value: success: false type: API code: AUTHORIZATION_ERROR error: Insufficient permissions transportNotAllowed: summary: >- This endpoint cannot be accessed with this authentication method value: success: false type: API code: TRANSPORT_NOT_ALLOWED error: >- This endpoint cannot be accessed with this authentication method missingPermission: summary: API key lacks the permission required for this endpoint value: success: false type: API code: MISSING_PERMISSION error: API key lacks the permission required for this endpoint ipNotAllowed: summary: This API key is not permitted from your IP address value: success: false type: API code: IP_NOT_ALLOWED error: This API key is not permitted from your IP address '422': description: Validation error content: application/json: schema: type: object properties: success: type: boolean enum: - false type: type: string enum: - API code: type: string enum: - VALIDATION_ERROR error: type: string enum: - Validation error details: type: object additionalProperties: type: object properties: _errors: type: array items: type: string required: - success - type - code - error - details example: success: false type: API code: VALIDATION_ERROR error: Validation error details: _errors: - The whole schema has some validation problems some_field: _errors: - This field has some validation problem '500': description: Internal Server Error content: application/json: schema: type: object properties: success: type: boolean enum: - false type: type: string enum: - API code: type: string enum: - INTERNAL_ERROR error: type: string enum: - Internal server error details: nullable: true required: - success - type - code - error example: success: false type: API code: INTERNAL_ERROR error: Internal server error security: - bearerAuth: [] components: schemas: AppNode: type: object properties: id: type: string name: type: string maxLength: 100 slug: type: string maxLength: 63 description: type: string default: '' city: type: string nullable: true maxLength: 100 countryCode: type: string nullable: true maxLength: 2 region: type: string nullable: true maxLength: 10 installedAt: type: string nullable: true format: date-time createdAt: type: string format: date-time updatedAt: type: string format: date-time required: - name - slug - updatedAt title: AppNode description: Schema for AppNode model example: id: 00000000-0000-4000-8000-000000000000 name: Kansas City 01 slug: appsus001 description: '' city: Kansas City countryCode: US region: US state: active fqdn: node-appsus001.storiza.app createdAt: '2026-10-09T14:57:33.856Z' schedulable: true securitySchemes: bearerAuth: type: http scheme: bearer description: >- An API key from the Storiza dashboard (API & Integrations), sent as `Authorization: Bearer stz_…`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.