--- title: list-projects-in-a-microfrontends-group product: vercel url: /docs/rest-api/microfrontends/list-projects-in-a-microfrontends-group canonical_url: "https://vercel.com/docs/rest-api/microfrontends/list-projects-in-a-microfrontends-group" last_updated: 2026-05-11 type: reference prerequisites: [] related: - /docs/rest-api summary: Learn about list-projects-in-a-microfrontends-group on Vercel. install_vercel_plugin: npx plugins add vercel/vercel-plugin --- # List projects in a microfrontends group ```http GET /v1/microfrontends/groups/{groupId}/projects ``` Get the microfrontends for a given group ID. ## Authentication **bearerToken**: HTTP bearer ## Path parameters | Name | Type | Required | Description | |---|---|---|---| | `groupId` | string | Yes | | ## Query parameters | Name | Type | Required | Description | |---|---|---|---| | `teamId` | string | No | The Team identifier to perform the request on behalf of. | | `slug` | string | No | The Team slug to perform the request on behalf of. | ## Responses ### 200: No description Content-Type: `application/json` ```json { "type": "object", "required": [ "projects" ], "properties": { "projects": { "type": "array", "items": { "type": "object", "required": [ "accountId", "defaultResourceConfig", "deploymentExpiration", "directoryListing", "id", "name", "nodeVersion", "resourceConfig" ], "properties": { "accountId": { "type": "string" }, "analytics": { "type": "object", "required": [ "disabledAt", "enabledAt", "id" ] }, "appliedCve55182Migration": { "type": "boolean", "enum": [ false, true ] }, "speedInsights": { "type": "object", "required": [ "id" ] }, "autoExposeSystemEnvs": { "type": "boolean", "enum": [ false, true ] }, "autoAssignCustomDomains": { "type": "boolean", "enum": [ false, true ] }, "autoAssignCustomDomainsUpdatedBy": { "type": "string" }, "buildCommand": { "type": "string", "nullable": true }, "commandForIgnoringBuildStep": { "type": "string", "nullable": true }, "connectConfigurations": { "type": "array", "nullable": true }, "connectConfigurationId": { "type": "string", "nullable": true }, "connectBuildsEnabled": { "type": "boolean", "enum": [ false, true ] }, "passiveConnectConfigurationId": { "type": "string", "nullable": true }, "createdAt": { "type": "number" }, "customerSupportCodeVisibility": { "type": "boolean", "enum": [ false, true ] }, "crons": { "type": "object", "required": [ "definitions", "deploymentId", "disabledAt", "enabledAt", "updatedAt" ] }, "dataCache": { "type": "object", "required": [ "userDisabled" ] }, "delegatedProtection": { "type": "object", "nullable": true }, "deploymentExpiration": { "type": "object", "description": "Retention policies for deployments. These are enforced at the project level, but we also maintain an instance of this at the team level as a default policy that gets applied to new projects." }, "expiration": { "type": "object" }, "devCommand": { "type": "string", "nullable": true }, "directoryListing": { "type": "boolean", "enum": [ false, true ] }, "installCommand": { "type": "string", "nullable": true }, "env": { "type": "array" }, "customEnvironments": { "type": "array" }, "framework": { "type": "string", "enum": [ "services", "node", "python", "blitzjs", "nextjs", "gatsby", "remix", "react-router", "astro", "hexo", "eleventy", "docusaurus-2", "docusaurus", "preact", "solidstart-1", "solidstart", "dojo", "ember", "vue", "scully", "ionic-angular", "angular", "polymer", "svelte", "sveltekit", "sveltekit-1", "ionic-react", "create-react-app", "gridsome", "umijs", "sapper", "saber", "stencil", "nuxtjs", "redwoodjs", "hugo", "jekyll", "brunch", "middleman", "zola", "hydrogen", "vite", "tanstack-start", "vitepress", "vuepress", "parcel", "fastapi", "flask", "fasthtml", "django", "sanity-v3", "sanity", "storybook", "nitro", "hono", "express", "h3", "koa", "nestjs", "elysia", "fastify", "xmcp", "ruby", "rust", "axum", "actix-web", "go", "mastra", null ], "nullable": true }, "gitForkProtection": { "type": "boolean", "enum": [ false, true ] }, "gitLFS": { "type": "boolean", "enum": [ false, true ] }, "id": { "type": "string" }, "ipBuckets": { "type": "array" }, "jobs": { "type": "object" }, "latestDeployments": { "type": "array" }, "link": {}, "microfrontends": {}, "name": { "type": "string" }, "nodeVersion": { "type": "string", "enum": [ "24.x", "22.x", "20.x", "18.x", "16.x", "14.x", "12.x", "10.x", "8.10.x" ] }, "optionsAllowlist": { "type": "object", "nullable": true, "required": [ "paths" ] }, "outputDirectory": { "type": "string", "nullable": true }, "passwordProtection": { "type": "object", "nullable": true }, "productionDeploymentsFastLane": { "type": "boolean", "enum": [ false, true ] }, "publicSource": { "type": "boolean", "enum": [ false, true, null ], "nullable": true }, "resourceConfig": { "type": "object", "required": [ "functionDefaultRegions" ] }, "rollbackDescription": { "type": "object", "description": "Description of why a project was rolled back, and by whom. Note that lastAliasRequest contains the from/to details of the rollback.", "required": [ "createdAt", "description", "userId", "username" ] }, "rollingRelease": { "type": "object", "description": "Project-level rolling release configuration that defines how deployments should be gradually rolled out", "nullable": true, "required": [ "target" ] }, "defaultResourceConfig": { "type": "object", "required": [ "functionDefaultRegions" ] }, "rootDirectory": { "type": "string", "nullable": true }, "serverlessFunctionZeroConfigFailover": { "type": "boolean", "enum": [ false, true ] }, "skewProtectionBoundaryAt": { "type": "number" }, "skewProtectionMaxAge": { "type": "number" }, "skewProtectionAllowedDomains": { "type": "array" }, "skipGitConnectDuringLink": { "type": "boolean", "enum": [ false, true ] }, "staticIps": { "type": "object", "required": [ "builds", "enabled", "regions" ] }, "sourceFilesOutsideRootDirectory": { "type": "boolean", "enum": [ false, true ] }, "enableAffectedProjectsDeployments": { "type": "boolean", "enum": [ false, true ] }, "enableExternalRewriteCaching": { "type": "boolean", "enum": [ false, true ] }, "ssoProtection": { "type": "object", "nullable": true, "required": [ "deploymentType" ] }, "targets": { "type": "object" }, "transferCompletedAt": { "type": "number" }, "transferStartedAt": { "type": "number" }, "transferToAccountId": { "type": "string" }, "transferredFromAccountId": { "type": "string" }, "updatedAt": { "type": "number" }, "live": { "type": "boolean", "enum": [ false, true ] }, "enablePreviewFeedback": { "type": "boolean", "enum": [ false, true, null ], "nullable": true }, "enableProductionFeedback": { "type": "boolean", "enum": [ false, true, null ], "nullable": true }, "permissions": { "type": "object" }, "lastRollbackTarget": { "type": "object", "nullable": true }, "lastAliasRequest": { "type": "object", "nullable": true, "required": [ "fromDeploymentId", "jobStatus", "requestedAt", "toDeploymentId", "type" ] }, "protectionBypass": { "type": "object" }, "hasActiveBranches": { "type": "boolean", "enum": [ false, true ] }, "trustedIps": { "nullable": true }, "trustedSources": { "type": "object", "nullable": true }, "gitComments": { "type": "object", "required": [ "onCommit", "onPullRequest" ] }, "gitProviderOptions": { "type": "object", "required": [ "createDeployments" ] }, "paused": { "type": "boolean", "enum": [ false, true ] }, "concurrencyBucketName": { "type": "string" }, "webAnalytics": { "type": "object", "required": [ "id" ] }, "security": { "type": "object" }, "oidcTokenConfig": { "type": "object" }, "tier": { "type": "string" }, "flatRateTier": { "type": "string", "enum": [ "standard", "base", "advanced", "critical" ] }, "usageStatus": { "type": "object", "required": [ "kind" ] }, "features": { "type": "object" }, "v0": { "type": "boolean", "enum": [ false, true ] }, "v0Created": { "type": "boolean", "enum": [ false, true ] }, "abuse": { "type": "object", "required": [ "history", "updatedAt" ] }, "internalRoutes": { "type": "array" }, "hasDeployments": { "type": "boolean", "enum": [ false, true ] }, "dismissedToasts": { "type": "array" }, "protectedSourcemaps": { "type": "boolean", "enum": [ false, true ] }, "tracing": { "type": "object" } } } } } } ``` ### 400: One of the provided values in the request query is invalid. ### 401: The request is not authorized. ### 403: You do not have permission to access this resource. --- ## Related - [microfrontends endpoints](/docs/rest-api#microfrontends) - [REST API overview](/docs/rest-api) - [OpenAPI spec](https://openapi.vercel.sh/) (machine-readable, all endpoints) --- [View full sitemap](/docs/sitemap)