---
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","description":"The number of results returned per page. Defaults to 30, and is capped at 100 when the request has no parent entity filter.","example":30}}},"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>