---
id: application-list
title: "List applications"
description: "Lists applications within a namespace."
sidebar_label: "List applications"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get api-method"
info_path: docs/api/application
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"List applications"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/application"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Lists applications within a namespace.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"query","name":"offset","schema":{"type":"integer","minimum":0},"description":"The starting point for pagination. Defaults to 0 if not provided.","example":0},{"in":"query","name":"limit","schema":{"type":"integer"},"description":"The maximum number of results to return per page.","example":30},{"in":"query","name":"namespace_id","example":"5678,1234","schema":{"type":"string"},"required":true,"description":"The namespace ID for the applications being listed. Allows up to 10 comma-separated values."}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The list of applications matching the query.","content":{"application/json":{"schema":{"type":"object","required":["paging","results"],"properties":{"paging":{"type":"object","required":["offset","limit","total"],"properties":{"total":{"type":"integer","description":"The total number of results matching the query.","example":30},"offset":{"type":"integer","minimum":0,"description":"The starting point for pagination. Defaults to 0 if not provided.","example":0},"limit":{"type":"integer","maximum":200,"description":"The maximum number of results to return per page. The maximum allowed value is 200.","example":200}}},"results":{"type":"array","items":{"type":"object","required":["id","name","slug","status","namespace_id","repository_url","is_mono_repo","auto_deploy_on_creation","template_id"],"properties":{"id":{"type":"integer","description":"A system-wide unique ID for the application.","example":1234},"nrn":{"type":"string","description":"The NRN (Nullplatform Resource Name) uniquely identifying this application in the nullplatform hierarchy.","example":"organization=1:account=2:namespace=3:application=4"},"name":{"type":"string","maxLength":60,"description":"The application name.","example":"Billing API"},"slug":{"type":"string","maxLength":60,"description":"A namespace-wide unique slug for the application.","example":"billing-api"},"namespace_id":{"type":"integer","description":"The ID of the namespace that owns this application.","example":2345},"status":{"type":"string","enum":["pending","creating","updating","active","inactive","failed","deleting"],"description":"The status of the application.","example":"active"},"repository_url":{"type":"string","maxLength":250,"description":"The URL of the repository that holds this application.","example":"https://github.com/crypto-inc/accounting-billing-api"},"repository_app_path":{"type":"string","description":"The folder where the application is located inside a monorepo.","example":null,"nullable":true},"is_mono_repo":{"type":"boolean","description":"True if the application shares the repository with other apps, false otherwise.","example":false},"auto_deploy_on_creation":{"type":"boolean","description":"True if the application must be deployed immediately after being created, false otherwise.","example":false},"template_id":{"type":"integer","description":"The ID of the template used to create this application.","example":3456},"metadata":{"type":"object","description":"The metadata loaded via the metadata catalog API.","example":{"key":"value"},"properties":{"key":{"type":"string","description":"The key of the metadata.","example":"key"},"value":{"type":"string","description":"The value of the metadata.","example":"value"},"additional_properties":{"type":"object","description":"Additional properties of the metadata.","properties":{"schemas":{"type":"array","description":"The JSON schemas of the metadata."},"tags":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","example":"key"},"value":{"type":"string","example":"value"}}}}}}},"title":"MetadataComponent"},"settings":{"type":"object","nullable":true,"description":"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.","properties":{"defaults":{"type":"object","nullable":true,"description":"Default values nullplatform falls back to when a branch or environment isn't specified explicitly.","properties":{"branch":{"type":"string","nullable":true,"description":"Default branch name for the application.","example":"main"},"environment":{"type":"string","nullable":true,"description":"Default environment name for the application.","example":"staging"}}},"asset":{"type":"object","nullable":true,"description":"Settings describing where the application's build assets are stored.","properties":{"docker_server":{"type":"object","nullable":true,"description":"Settings for the application's Docker server assets.","properties":{"uri":{"type":"string","nullable":true,"description":"Location where the application's Docker server assets are stored.","example":"registry.example.com/acme-corp/billing-api"}}},"ecr":{"type":"object","nullable":true,"description":"Amazon ECR repository where the application's assets are stored.","properties":{"uri":{"type":"string","nullable":true,"description":"ECR repository URI for the application's assets.","example":"123456789012.dkr.ecr.us-east-1.amazonaws.com/billing-api"},"arn":{"type":"string","nullable":true,"description":"ECR repository ARN for the application's assets.","example":"arn:aws:ecr:us-east-1:123456789012:repository/billing-api"}}}}},"code_repository":{"type":"object","nullable":true,"description":"Configuration of the code repository provider the application is linked to.","properties":{"specification_id":{"type":"string","format":"uuid","nullable":true,"description":"Unique identifier of the code repository specification.","example":"7f3c910e-8138-4d65-9d09-b97d89f2c509"},"specification_slug":{"type":"string","nullable":true,"description":"Slug of the code repository specification.","example":"github-configuration"},"specification_name":{"type":"string","nullable":true,"description":"Display name of the code repository specification.","example":"GitHub"},"specification_icon":{"type":"string","nullable":true,"description":"Icon identifier for the code repository specification.","example":"github"},"provider_id":{"type":"string","format":"uuid","nullable":true,"description":"Unique identifier of the code repository provider.","example":"82eee42c-46c9-4bb7-a53d-c08b027817f3"}}}},"title":"applicationSettings"}},"title":"application"}}},"title":"applicationListResponse"}}}},"4XX":{"description":"Client error responses due to invalid input or missing parameters.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific client error (e.g., 400, 401, 403, 404).","example":400},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"bad_request"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Bad Request\", \"Unauthorized\").","example":"Bad Request"},"message":{"type":"string","description":"Additional details about the error.","example":"The request was malformed or contained invalid parameters."}}}}}},"5XX":{"description":"Server error responses indicating an issue on the API side.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific server error (e.g., 500, 502, 503).","example":500},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"internal_server_error"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Internal Server Error\", \"Service Unavailable\").","example":"Internal Server Error"},"message":{"type":"string","description":"Additional details about the error.","example":"An unexpected error occurred. Please try again later."}}}}}}}}
>
  
</StatusCodes>