---
title: "Returns cost data for a FAR 51 Authorization"
method: GET
path: "/far51/{far51AuthorizationId}/costs"
tags: ["cost"]
---

# Returns cost data for a FAR 51 Authorization

`GET /far51/{far51AuthorizationId}/costs`

## Request

- The document declares no server URL.
- Auth: OpenID Connect (`https://cognito-idp-fips.us-gov-west-1.amazonaws.com/us-gov-west-1_2e6R3aYgi/.well-known/openid-configuration`, scopes: `atat/read-cost`)

Queries CSP for actual cost data for a given FAR Part 51 Authorization and time period. 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. If the date range requested by the client includes periods for which no data exists, the server must return whatever matching cost data does exist rather than respond with an error code.

## Path parameters

- `far51AuthorizationId` string, required

## Query parameters

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

## Response `200`

Cost operation successful

- 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`: Far Part 51 Authorization not found

## Changes

- **2024-06-07** `39e872de1898`: 1 breaking, 2 info
  - the response's body type changed from `array` to no type for status `200`
  - added the required property `results` to the response with the `200` status
  - added the required property `total` to the response with the `200` status
- **2024-06-03** `2ac0a47a99c2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/dod-ccpo/apis/atat-csp-api/changes/far51/:far51AuthorizationId/costs/get.md)

---

[API](https://skmtc.dev/dod-ccpo/apis/atat-csp-api.md) - [All operations](https://skmtc.dev/dod-ccpo/apis/atat-csp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dod-ccpo/apis/atat-csp-api/revisions/22014acb308f?raw)