---
title: "List applications"
method: GET
path: "/application"
tags: ["Application"]
---

# List applications

`GET /application`

Lists applications within a namespace.

## Query parameters

- `offset` integer
- `limit` integer
- `namespace_id` string, required

## Response `200`

The list of applications matching the query.

- ApplicationListResponse
  - `paging` object, required
    - `total` integer, required — The total number of results matching the query.
    - `offset` integer, required — The starting point for pagination. Defaults to 0 if not provided.
    - `limit` integer, required — The maximum number of results to return per page. The maximum allowed value is 200.
  - `results` Application[], required
    - `id` integer, required — A system-wide unique ID for the application.
    - `nrn` string — The NRN (Nullplatform Resource Name) uniquely identifying this application in the nullplatform hierarchy.
    - `name` string, required — The application name.
    - `slug` string, required — A namespace-wide unique slug for the application.
    - `namespace_id` integer, required — The ID of the namespace that owns this application.
    - `status` 'pending' | 'creating' | 'updating' | 'active' | 'inactive' | 'failed' | 'deleting', required — The status of the application.
    - `repository_url` string, required — The URL of the repository that holds this application.
    - `repository_app_path` string, nullable — The folder where the application is located inside a monorepo.
    - `is_mono_repo` boolean, required — True if the application shares the repository with other apps, false otherwise.
    - `auto_deploy_on_creation` boolean, required — True if the application must be deployed immediately after being created, false otherwise.
    - `template_id` integer, required — The ID of the template used to create this application.
    - `metadata` SchemasMetadataComponent — The metadata loaded via the metadata catalog API.
      - `key` string — The key of the metadata.
      - `value` string — The value of the metadata.
      - `additional_properties` object — Additional properties of the metadata.
        - `schemas` unknown[] — The JSON schemas of the metadata.
          - unknown
        - `tags` object[]
          - `key` string
          - `value` string
    - `settings` ApplicationSettings, nullable — Configuration settings for the application. When updating via PATCH, follows RFC 7396 (JSON Merge Patch): keys with null values are deleted, keys with non-null values are updated/created, omitted keys are preserved.
      - `defaults` object, nullable — Default values nullplatform falls back to when a branch or environment isn't specified explicitly.
        - `branch` string, nullable — Default branch name for the application.
        - `environment` string, nullable — Default environment name for the application.
      - `asset` object, nullable — Settings describing where the application's build assets are stored.
        - `docker_server` object, nullable — Settings for the application's Docker server assets.
          - `uri` string, nullable — Location where the application's Docker server assets are stored.
        - `ecr` object, nullable — Amazon ECR repository where the application's assets are stored.
          - `uri` string, nullable — ECR repository URI for the application's assets.
          - `arn` string, nullable — ECR repository ARN for the application's assets.
      - `code_repository` object, nullable — Configuration of the code repository provider the application is linked to.
        - `specification_id` string, uuid, nullable — Unique identifier of the code repository specification.
        - `specification_slug` string, nullable — Slug of the code repository specification.
        - `specification_name` string, nullable — Display name of the code repository specification.
        - `specification_icon` string, nullable — Icon identifier for the code repository specification.
        - `provider_id` string, uuid, nullable — Unique identifier of the code repository provider.

## Other responses

- `4XX` — Client error responses due to invalid input or missing parameters.
- `5XX` — Server error responses indicating an issue on the API side.

---

[API](https://skmtc.dev/nullplatform/apis/nullplatform-api.md) · [All operations](https://skmtc.dev/nullplatform/apis/nullplatform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nullplatform/nullplatform-api/revisions/1c4ea154b159/schema)