---
title: "GET /portfolios/{accountId}"
method: GET
path: "/portfolios/{accountId}"
tags: ["Portfolios"]
---

# GET /portfolios/{accountId}

`GET /portfolios/{accountId}`

## Request

- Base URL: `https://api.craft.io`
- URL: `https://api.craft.io/portfolios/{accountId}`
- Auth: API key in header `x-api-key`

Get the list of your account’s portfolios and the workspaces they are connected with

## Path parameters

- `accountId` string, required

## Response `200`

A list of portfolios

- Portfolio[]
  - `id` string
  - `name` string, nullable
  - `workspaces` Workspace[], required
    - `id` string
    - `name` string, nullable
    - `key` string
    - `webUrl` string: Canonical Craft.io app URL for this workspace. Computed in PublishService.
  - `webUrl` string: Canonical Craft.io app URL for this portfolio. Computed in PublishService.

## Other responses

- `400`: Invalid account ID
- `401`: No access to account
- `403`: Access denied
- `500`: An error occurred while fetching portfolios

## Changes

- **2026-10-01** `6009bb084cb5`: 4 info
  - added the optional property `error` to the response with the `400` status
  - added the optional property `error` to the response with the `401` status
  - added the optional property `error` to the response with the `403` status
  - added the optional property `error` to the response with the `500` status

[Operation history](https://skmtc.dev/craft/apis/craft-io-public-api/changes/portfolios/:accountId/get.md)

---

[API](https://skmtc.dev/craft/apis/craft-io-public-api.md) - [All operations](https://skmtc.dev/craft/apis/craft-io-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/craft/apis/craft-io-public-api/revisions/2972a1b05ab1?raw)