--- title: List Applications associated with your account --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Containers](https://developers.cloudflare.com/api/go/resources/containers) [Applications](https://developers.cloudflare.com/api/go/resources/containers/subresources/applications) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Applications associated with your account client.Containers.Applications.List(ctx, params) (\*PageTokenPagination\[[ApplicationListResponse]()], error) GET/accounts/{account\_id}/containers/applications Lists all the applications that are associated with your account. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### ParametersExpand Collapse
params ApplicationListParams AccountID param.Field\[string] Path param: Account identifier. Link to this property Image param.Field\[string]Optional Query param: Filter applications by image. Link to this property Name param.Field\[string]Optional Query param: Filter applications by name. Link to this property PageToken param.Field\[string]Optional Query param: Opaque token from a previous response to retrieve the next page. Link to this property PerPage param.Field\[int64]Optional Query param: Maximum number of applications to return per page. Defaults to all, or 100 when page_token is set. maximum500 minimum1 Link to this property
[Link to this property](<#(resource)%20containers.applications%20%3E%20(method)%20list%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type ApplicationListResponse interface{…} The public Containers API returns an application. One of the following:
type ApplicationListResponseCcScheduledApplication struct{…} Describes an application and the parameters that govern how it places its instances. ID string An Application ID represents an identifier of an application. Link to this property AccountID string A unique identifier for the user’s account. Link to this property
Configuration ApplicationListResponseCcScheduledApplicationConfiguration User-specified container configuration. Image string Image url. Link to this property
AuthorizedKeys \[]ApplicationListResponseCcScheduledApplicationConfigurationAuthorizedKeyOptional PublicKey string An SSH public key. Link to this property Name stringOptional Optional human readable name for this key. Link to this property
Link to this property Command \[]stringOptional The command that runs when the container starts, passed to the entrypoint. You can override this at run-time. If you override only the command, it gets passed to the default entrypoint specified in the image. Link to this property Entrypoint \[]stringOptional The entry point for the container, specifying the executable to run when the container starts. You can override this at run-time. If you do, the default command from the image is ignored. Specify both entrypoint and command at run-time to completely replace the image defaults. Link to this property
EnvironmentVariables \[]ApplicationListResponseCcScheduledApplicationConfigurationEnvironmentVariableOptional Container environment variables. Name string An environment variable name. Link to this property Value string An environment variable value. Link to this property
Link to this property
InstanceType ApplicationListResponseCcScheduledApplicationConfigurationInstanceTypeOptional The instance type configures vCPU, memory, and disk. - “lite”: 1/16 vCPU, 256 MiB memory, 2 GB disk - “basic”: 1/4 vCPU, 1 GiB memory, 4 GB disk - “standard-1”: 1/2 vCPU, 4 GiB memory, 8 GB disk - “standard-2”: 1 vCPU, 6 GiB memory, 12 GB disk - “standard-3”: 2 vCPU, 8 GiB memory, 16 GB disk - “standard-4”: 4 vCPU, 12 GiB memory, 20 GB disk One of the following: const ApplicationListResponseCcScheduledApplicationConfigurationInstanceTypeLite ApplicationListResponseCcScheduledApplicationConfigurationInstanceType = "lite" Link to this property const ApplicationListResponseCcScheduledApplicationConfigurationInstanceTypeBasic ApplicationListResponseCcScheduledApplicationConfigurationInstanceType = "basic" Link to this property const ApplicationListResponseCcScheduledApplicationConfigurationInstanceTypeStandard1 ApplicationListResponseCcScheduledApplicationConfigurationInstanceType = "standard-1" Link to this property const ApplicationListResponseCcScheduledApplicationConfigurationInstanceTypeStandard2 ApplicationListResponseCcScheduledApplicationConfigurationInstanceType = "standard-2" Link to this property const ApplicationListResponseCcScheduledApplicationConfigurationInstanceTypeStandard3 ApplicationListResponseCcScheduledApplicationConfigurationInstanceType = "standard-3" Link to this property const ApplicationListResponseCcScheduledApplicationConfigurationInstanceTypeStandard4 ApplicationListResponseCcScheduledApplicationConfigurationInstanceType = "standard-4" Link to this property
Link to this property
Observability ApplicationListResponseCcScheduledApplicationConfigurationObservabilityOptional Settings for deployment observability such as logging.
Logs ApplicationListResponseCcScheduledApplicationConfigurationObservabilityLogsOptional Observability logging settings. Enabled boolOptional Link to this property
Link to this property
Link to this property
Link to this property CreatedAt string UTC timestamp string in ISO 8601 format. Link to this property Instances int64 Number of deployments to create. Link to this property Name string The application name. Link to this property
SchedulingPolicy ApplicationListResponseCcScheduledApplicationSchedulingPolicy The scheduling policy to use for an application. One of the following: const ApplicationListResponseCcScheduledApplicationSchedulingPolicyDefault ApplicationListResponseCcScheduledApplicationSchedulingPolicy = "default" Link to this property const ApplicationListResponseCcScheduledApplicationSchedulingPolicyDurableObject ApplicationListResponseCcScheduledApplicationSchedulingPolicy = "durable\_object" Link to this property
Link to this property UpdatedAt string UTC timestamp string in ISO 8601 format. Link to this property Version int64 Link to this property ActiveRolloutID stringOptional An identifier for a specific rollout within an application. Link to this property
Constraints ApplicationListResponseCcScheduledApplicationConstraintsOptional Jurisdiction stringOptional Restricts placement to datacenters in the selected jurisdiction. Choose “eu”, “fedramp”, or “us”. When combined with regions, EU supports EEUR and WEUR while FedRAMP and US support ENAM and WNAM. Link to this property Regions \[]stringOptional Link to this property
Link to this property
DurableObjects ApplicationListResponseCcScheduledApplicationDurableObjectsOptional Durable object configuration stored on and returned from a Cloudchamber application. NamespaceID string The namespace ID of the durable object namespace to use for this application. Link to this property
Link to this property
Health ApplicationListResponseCcScheduledApplicationHealthOptional
Errors \[]ApplicationListResponseCcScheduledApplicationHealthError
Event ApplicationListResponseCcScheduledApplicationHealthErrorsEvent An event within a Placement or a Job. ID string Link to this property Details map\[string, unknown] Link to this property Message string Link to this property
Name ApplicationListResponseCcScheduledApplicationHealthErrorsEventName Name of the event that describes the kind event that happened. - SchedulerPlaced: It’s the first event that creates a container placement. It happens when the Containers runtime was able to retrieve deployment resources and start verifying everything is correct. - NetworkingIPAssigned: It’s sent when the Containers runtime maps the IP to the container. - VMStarted: It’s sent when the Containers runtime starts the VM. The container might remain unhealthy at this point. - ImagePulled: It’s sent when the Containers runtime pulls the image successfully. - ImagePullError: It’s sent when the Containers runtime is having issues pulling the image. The message and details have more information on what happened for debugging. - VMFailedToStart: It’s sent when the Containers runtime was unable to boot the VM. - VMStopping: It’s sent when the scheduler is stopping the VM. - VMStopped: It’s sent when the VM finally exits. - VMFailed: It’s sent when the scheduling of the VM failed in the current location. - RuntimeStartFailed: It’s sent when the runtime hits an internal error. - SSHStarted: It’s sent when the container gains network connectivity and opens the SSH port. Containers only send this event when SSH keys exist. - CheckUpdate: Sent when the status of a health or readiness check changes. This may also affect the health status of the placement. - DurableObjectConnected: Sent when a durable object instance connects and gains control of the deployment. This event is only sent for durable object deployments. It is sent after VMStarted. - ContainerStarted: It’s sent when the container starts running. One of the following: const ApplicationListResponseCcScheduledApplicationHealthErrorsEventNameSchedulerPlaced ApplicationListResponseCcScheduledApplicationHealthErrorsEventName = "SchedulerPlaced" Link to this property const ApplicationListResponseCcScheduledApplicationHealthErrorsEventNameNetworkingIPAssigned ApplicationListResponseCcScheduledApplicationHealthErrorsEventName = "NetworkingIPAssigned" Link to this property const ApplicationListResponseCcScheduledApplicationHealthErrorsEventNameVmStarted ApplicationListResponseCcScheduledApplicationHealthErrorsEventName = "VMStarted" Link to this property const ApplicationListResponseCcScheduledApplicationHealthErrorsEventNameImagePulled ApplicationListResponseCcScheduledApplicationHealthErrorsEventName = "ImagePulled" Link to this property const ApplicationListResponseCcScheduledApplicationHealthErrorsEventNameImagePullError ApplicationListResponseCcScheduledApplicationHealthErrorsEventName = "ImagePullError" Link to this property const ApplicationListResponseCcScheduledApplicationHealthErrorsEventNameVmFailedToStart ApplicationListResponseCcScheduledApplicationHealthErrorsEventName = "VMFailedToStart" Link to this property const ApplicationListResponseCcScheduledApplicationHealthErrorsEventNameNetworkingIPAssignmentFailed ApplicationListResponseCcScheduledApplicationHealthErrorsEventName = "NetworkingIPAssignmentFailed" Link to this property const ApplicationListResponseCcScheduledApplicationHealthErrorsEventNameVmRunning ApplicationListResponseCcScheduledApplicationHealthErrorsEventName = "VMRunning" Link to this property const ApplicationListResponseCcScheduledApplicationHealthErrorsEventNameVmStopping ApplicationListResponseCcScheduledApplicationHealthErrorsEventName = "VMStopping" Link to this property const ApplicationListResponseCcScheduledApplicationHealthErrorsEventNameVmStopped ApplicationListResponseCcScheduledApplicationHealthErrorsEventName = "VMStopped" Link to this property const ApplicationListResponseCcScheduledApplicationHealthErrorsEventNameVmFailed ApplicationListResponseCcScheduledApplicationHealthErrorsEventName = "VMFailed" Link to this property const ApplicationListResponseCcScheduledApplicationHealthErrorsEventNameRuntimeStartFailed ApplicationListResponseCcScheduledApplicationHealthErrorsEventName = "RuntimeStartFailed" Link to this property const ApplicationListResponseCcScheduledApplicationHealthErrorsEventNameSSHStarted ApplicationListResponseCcScheduledApplicationHealthErrorsEventName = "SSHStarted" Link to this property const ApplicationListResponseCcScheduledApplicationHealthErrorsEventNameServiceHealthUpdates ApplicationListResponseCcScheduledApplicationHealthErrorsEventName = "ServiceHealthUpdates" Link to this property const ApplicationListResponseCcScheduledApplicationHealthErrorsEventNameCheckUpdate ApplicationListResponseCcScheduledApplicationHealthErrorsEventName = "CheckUpdate" Link to this property const ApplicationListResponseCcScheduledApplicationHealthErrorsEventNameDurableObjectConnected ApplicationListResponseCcScheduledApplicationHealthErrorsEventName = "DurableObjectConnected" Link to this property const ApplicationListResponseCcScheduledApplicationHealthErrorsEventNameContainerStarted ApplicationListResponseCcScheduledApplicationHealthErrorsEventName = "ContainerStarted" Link to this property
Link to this property StatusChange map\[string, unknown] Link to this property Time string UTC timestamp string in ISO 8601 format. Link to this property
Type ApplicationListResponseCcScheduledApplicationHealthErrorsEventType One of the following: const ApplicationListResponseCcScheduledApplicationHealthErrorsEventTypeInfo ApplicationListResponseCcScheduledApplicationHealthErrorsEventType = "Info" Link to this property const ApplicationListResponseCcScheduledApplicationHealthErrorsEventTypeError ApplicationListResponseCcScheduledApplicationHealthErrorsEventType = "Error" Link to this property const ApplicationListResponseCcScheduledApplicationHealthErrorsEventTypeWarn ApplicationListResponseCcScheduledApplicationHealthErrorsEventType = "Warn" Link to this property const ApplicationListResponseCcScheduledApplicationHealthErrorsEventTypeUserError ApplicationListResponseCcScheduledApplicationHealthErrorsEventType = "UserError" Link to this property const ApplicationListResponseCcScheduledApplicationHealthErrorsEventTypeSystemError ApplicationListResponseCcScheduledApplicationHealthErrorsEventType = "SystemError" Link to this property
Link to this property
Link to this property InstanceID string An instance ID represents an identifier of an instance configuration that maintains an underlying placement. Link to this property
Link to this property
Instances ApplicationListResponseCcScheduledApplicationHealthInstances Shows a count of application instance states. Active int64 Number of instances whose runtime reports the container as running (container\_status = “running”). This is a subset of the placements that remain up: an instance that is already bound to a Durable Object and serving traffic is counted under “assigned” until its container\_status catches up to “running”, so container\_status can briefly lag Durable Object attachment under churn. To estimate running, Durable-Object-bound instances, sum “active” + “assigned” rather than reading “active” alone. Link to this property Assigned int64 Number of instances bound to a Durable Object with a running placement whose container\_status remains behind “running”. These count as live, serving instances; “active” + “assigned” approximates the running, Durable-Object-bound count. Link to this property
Link to this property
Summary ApplicationListResponseCcScheduledApplicationHealthSummaryOptional High-level health assessment. Only populated for “new\_instances” strategy. Based on a sample of target-version instances rather than a full count. - “pending”: Zero target-version instances exist yet. - “healthy”: Every sampled target-version instance reports running or active. - “degraded”: Some sampled instances remain starting or scheduling. - “unhealthy”: One or more sampled instances have failed. One of the following: const ApplicationListResponseCcScheduledApplicationHealthSummaryHealthy ApplicationListResponseCcScheduledApplicationHealthSummary = "healthy" Link to this property const ApplicationListResponseCcScheduledApplicationHealthSummaryDegraded ApplicationListResponseCcScheduledApplicationHealthSummary = "degraded" Link to this property const ApplicationListResponseCcScheduledApplicationHealthSummaryUnhealthy ApplicationListResponseCcScheduledApplicationHealthSummary = "unhealthy" Link to this property const ApplicationListResponseCcScheduledApplicationHealthSummaryPending ApplicationListResponseCcScheduledApplicationHealthSummary = "pending" Link to this property
Link to this property
Link to this property MaxInstances int64Optional Maximum number of instances the application allows. This is relevant for applications that auto-scale. Link to this property
Observability ApplicationListResponseCcScheduledApplicationObservabilityOptional Top-level observability settings for the application. This field is mutually exclusive with configuration.observability.
Logs ApplicationListResponseCcScheduledApplicationObservabilityLogsOptional Observability logging settings. Enabled boolOptional Link to this property
Link to this property
Link to this property RolloutActiveGracePeriod int64Optional Grace period for active instances to stay alive before becoming eligible for shutdown signal due to a rollout, in seconds. Defaults to 0. maximum604800 minimum0 Link to this property
Link to this property
type ApplicationListResponseCcDurableObjectApplication struct{…} Each Durable Object creates and manages the lifecycle of its container instance. ID string An Application ID represents an identifier of an application. Link to this property AccountID string A unique identifier for the user’s account. Link to this property CreatedAt string UTC timestamp string in ISO 8601 format. Link to this property
DurableObjects ApplicationListResponseCcDurableObjectApplicationDurableObjects Durable object configuration using a namespace ID. NamespaceID string The namespace ID of the durable object namespace to use for this application. Link to this property
Link to this property Name string The application name. Link to this property SchedulingPolicy ApplicationListResponseCcDurableObjectApplicationSchedulingPolicy Selects a Durable Object-managed application. Each Durable Object creates and manages the lifecycle of its container instance. Configure application-wide observability settings here. Deployment configuration, scaling, placement constraints, versions, and rollouts do not apply. Link to this property UpdatedAt string UTC timestamp string in ISO 8601 format. Link to this property
Configuration ApplicationListResponseCcDurableObjectApplicationConfigurationOptional Application-wide settings for a Durable Object-managed application.
AuthorizedKeys \[]ApplicationListResponseCcDurableObjectApplicationConfigurationAuthorizedKeyOptional PublicKey string An SSH public key. Link to this property Name stringOptional Optional human readable name for this key. Link to this property
Link to this property
WranglerSSH ApplicationListResponseCcDurableObjectApplicationConfigurationWranglerSSHOptional Configuration properties for connecting with SSH to a container using Wrangler. Enabled boolOptional Link to this property Port int64Optional maximum65535 minimum1 Link to this property
Link to this property
Link to this property
Health ApplicationListResponseCcDurableObjectApplicationHealthOptional Aggregate current activity for the latest observed placement of each instance. Runtime snapshots feed periodic background sweeps. Counts refresh after each complete sweep. Instance listings retain their separate three-month history for failure discovery.
Instances ApplicationListResponseCcDurableObjectApplicationHealthInstances Counts of observed non-terminal instances. Active int64 Number of instances whose runtime reports running or stopping. minimum0 Link to this property Starting int64 Number of instances whose runtime reports starting. minimum0 Link to this property
Link to this property Summary ApplicationListResponseCcDurableObjectApplicationHealthSummaryOptional Present as pending until the first activity sweep completes; omitted afterward. Link to this property
Link to this property
Observability ApplicationListResponseCcDurableObjectApplicationObservabilityOptional Application-wide logging settings for a Durable Object-managed application. The application publishes these settings to its runtime metadata. Updating them does not create a deployment or rollout.
Logs ApplicationListResponseCcDurableObjectApplicationObservabilityLogsOptional Application-wide logging settings. Enabled boolOptional Link to this property
Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20containers.applications%20%3E%20(model)%20ApplicationListResponse%20%3E%20(schema)>) ### List Applications associated with your account Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/containers" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) page, err := client.Containers.Applications.List(context.TODO(), containers.ApplicationListParams{ AccountID: cloudflare.F("account-123"), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": [ { "id": "id", "account_id": "account_id", "configuration": { "image": "image", "authorized_keys": [ { "public_key": "public_key", "name": "name" } ], "command": [ "myapp", "--default-option" ], "entrypoint": [ "/bin/bash" ], "environment_variables": [ { "name": "name", "value": "value" } ], "instance_type": "lite", "observability": { "logs": { "enabled": true } } }, "created_at": "2021-04-01T12:32:41.488Z", "instances": 0, "name": "name", "scheduling_policy": "default", "updated_at": "2021-04-01T12:32:41.488Z", "version": 0, "active_rollout_id": "active_rollout_id", "constraints": { "jurisdiction": "jurisdiction", "regions": [ "WNAM" ] }, "durable_objects": { "namespace_id": "14758f1afd44c09b7992073ccf00b43d" }, "health": { "errors": [ { "event": { "id": "id", "details": { "foo": "bar" }, "message": "message", "name": "SchedulerPlaced", "statusChange": { "foo": "bar" }, "time": "2021-04-01T12:32:41.488Z", "type": "Info" }, "instance_id": "instance_id" } ], "instances": { "active": 0, "assigned": 0 }, "summary": "healthy" }, "max_instances": 0, "observability": { "logs": { "enabled": true } }, "rollout_active_grace_period": 0 } ], "result_info": { "next_page_token": "next_page_token", "page_token": "page_token", "per_page": 0 }, "success": true } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": [ { "id": "id", "account_id": "account_id", "configuration": { "image": "image", "authorized_keys": [ { "public_key": "public_key", "name": "name" } ], "command": [ "myapp", "--default-option" ], "entrypoint": [ "/bin/bash" ], "environment_variables": [ { "name": "name", "value": "value" } ], "instance_type": "lite", "observability": { "logs": { "enabled": true } } }, "created_at": "2021-04-01T12:32:41.488Z", "instances": 0, "name": "name", "scheduling_policy": "default", "updated_at": "2021-04-01T12:32:41.488Z", "version": 0, "active_rollout_id": "active_rollout_id", "constraints": { "jurisdiction": "jurisdiction", "regions": [ "WNAM" ] }, "durable_objects": { "namespace_id": "14758f1afd44c09b7992073ccf00b43d" }, "health": { "errors": [ { "event": { "id": "id", "details": { "foo": "bar" }, "message": "message", "name": "SchedulerPlaced", "statusChange": { "foo": "bar" }, "time": "2021-04-01T12:32:41.488Z", "type": "Info" }, "instance_id": "instance_id" } ], "instances": { "active": 0, "assigned": 0 }, "summary": "healthy" }, "max_instances": 0, "observability": { "logs": { "enabled": true } }, "rollout_active_grace_period": 0 } ], "result_info": { "next_page_token": "next_page_token", "page_token": "page_token", "per_page": 0 }, "success": true } ```