---
title: "Gets an existing Portfolio"
method: GET
path: "/portfolios/{portfolioId}"
tags: ["provisioning"]
---

# Gets an existing Portfolio

`GET /portfolios/{portfolioId}`

Returns a single existing Portfolio, including Task Orders and Operators

## Response `200`

Portfolio successfully retrieved

- Portfolio — Initial Portfolio created to contain Environments, which is an empty shell that does not initially include Environments.
  - `id` string, required — Represents the unqiue ID of the Portfolio created by the vendor. In order to enable the ATAT UI to construct links back to the provisioned environment, this should be the same ID generated internally for the vendor's Portfolio-equivalent construct.
  - `name` string, required
  - `task_orders` TaskOrder[], required
    - `id` string, required — Represents the unique ID of a Task Order. Must be defined by CSPs upon object creation.
    - `task_order_number` string, required — Represents the current Task Order Number. Subject to change over the lifetime of a Task Order. Should be considered metadata rather than a primary key (use the `id` instead).
    - `clins` CLIN[], required
      - `clin_number` string, required — Contract Line Item Number (CLIN), 0001 through 9999
      - `type` 'CLOUD' | 'NON_CLOUD', required — Distinguishes a "CLOUD" CLIN, which directly funds cloud workloads, from "NON_CLOUD" CLINs, which do not.
      - `classification_level` 'UNCLASSIFIED' | 'SECRET' | 'TOP_SECRET' — Represents the classification level for this environment. Attempts to change this field via PUT or PATCH should result in a HTTP 400.
      - `pop_start_date` string, date, required — Start of period of performance for this CLIN in YYYY-MM-DD format.
      - `pop_end_date` string, date, required — End of period of performance for this CLIN in YYYY-MM-DD format.
    - `pop_start_date` string, date, required — Start of period of performance for this Task Order in YYYY-MM-DD format.
    - `pop_end_date` string, date, required — End of period of performance for this Task Order in YYYY-MM-DD format.

## Other responses

- `400` — Invalid ID supplied
- `404` — Portfolio not found

---

[API](https://skmtc.net/dod-ccpo/apis/atat-csp-api.md) · [All operations](https://skmtc.net/dod-ccpo/apis/atat-csp-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dod-ccpo/atat-csp-api/revisions/22014acb308f/schema)