---
title: "Returns cost data for a Portfolio, broken down by Task Order & CLINs"
method: GET
path: "/portfolios/{portfolioId}/costs"
tags: ["cost"]
---

# Returns cost data for a Portfolio, broken down by Task Order & CLINs

`GET /portfolios/{portfolioId}/costs`

Queries CSP for actual or forecasted cost data across a Portfolio. Queries should return data for all months included in date ranges. For example, a `start_date` of "2022-01-25" and `end_date` of "2022-03-02" should return data for January, February and March. It is expected that actual results will be provided for all months which have been invoiced while forecast data will be provided for all future months.

## Query parameters

- `start_date` string, date, required
- `end_date` string, date, required

## Response `200`

Cost operation successful

- CostResponseByPortfolio — Provides cost data in a format in accordance with the provided CostRequest. Implementors must provide actual data for any month in which real costs has been incurred, whether or not they have been invoiced. Forecast data should be supplied for any month which has not been invoiced. Specifically, this implies the following expectations: * Invoiced Past Months - actuals only * Un-invoiced Past Months - actuals and forecasts * Current Month - actuals and forecasts * Future Months - forecasts only **Note**: Forecast data is only required for CLIN's whose `type` is "CLOUD". For instance, vendors are not expected to provide forecast data for expenses such as travel or training.
  - `task_orders` object[], required
    - `task_order_id` string, required
    - `task_order_number` string, required
    - `clins` object[], required
      - `clin_number` string
      - `actual` CostData
        - `total` string, required — Total cost (ACTUAL or FORECAST) for all included months in USD
        - `results` object[], required
          - `month` string
          - `value` string — Cost (ACTUAL or FORECAST) for the given months in USD
      - `forecast` CostData
        - `total` string, required — Total cost (ACTUAL or FORECAST) for all included months in USD
        - `results` object[], required
          - `month` string
          - `value` string — Cost (ACTUAL or FORECAST) for the given months in USD

## Other responses

- `400` — Invalid ID or query parameters
- `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)