> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/infrastructure-as-code-management/iacm-api-reference/executions/list-cost-changes.md).

# List cost changes

List cost changes from the latest plan and last applied state for the current execution.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"executions","description":"Executions Service handles the API for workflow executions.\n\nAt this time it is a read-only API with no ability to directly create or edit\nexecutions. Instead these are triggered from the Workspaces Service."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/orgs/{org}/projects/{project}/executions/{pipeline_execution_id}/cost-changes":{"get":{"tags":["executions"],"summary":"List cost changes","description":"List cost changes from the latest plan and last applied state for the current execution.","operationId":"executions#list-cost-changes","parameters":[{"name":"pipeline_stage_id","in":"query","allowEmptyValue":true,"schema":{"type":"string","default":""}},{"name":"org","in":"path","description":"Org is the organisation identifier.","required":true,"schema":{"type":"string","description":"Org is the organisation identifier.","minLength":1,"maxLength":128}},{"name":"project","in":"path","description":"Project is the project identifier.","required":true,"schema":{"type":"string","description":"Project is the project identifier.","minLength":1,"maxLength":128}},{"name":"pipeline_execution_id","in":"path","description":"Pipeline execution ID","required":true,"schema":{"type":"string","description":"Pipeline execution ID","minLength":1,"maxLength":128}},{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListCostChangesResponse"}}}},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"ListCostChangesResponse":{"type":"object","properties":{"currency":{"type":"string","description":"Currency of the costs"},"diff":{"type":"object","description":"Map of the type of resources and their costs.","additionalProperties":{"$ref":"#/components/schemas/HarnessIacmCostResourcesByType"}},"diff_total_monthly_cost":{"type":"string","description":"Difference of cost between workspaces per month"},"past_total_monthly_cost":{"type":"string","description":"Total cost of the resources per month for the last workspace"},"percentage_change_total_monthly_cost":{"type":"integer","description":"The change between the costs per month represented as a percentage","format":"int64"},"stage_execution_id":{"type":"string","description":"The stage execution ID"},"stage_id":{"type":"string","description":"The stage ID"},"total_monthly_cost":{"type":"string","description":"Total cost of the resources per month"},"workspace_id":{"type":"string","description":"The workspace identifier"}},"required":["currency","diff","total_monthly_cost","past_total_monthly_cost","diff_total_monthly_cost","percentage_change_total_monthly_cost","stage_id","stage_execution_id","workspace_id"]},"HarnessIacmCostResourcesByType":{"type":"object","properties":{"current_monthly_cost":{"type":"string"},"diff":{"$ref":"#/components/schemas/CostResourcesCollection"},"diff_monthly_cost":{"type":"string"},"percentage_change_monthly_cost":{"type":"integer","format":"int64"},"previous_monthly_cost":{"type":"string"}},"required":["diff","current_monthly_cost","previous_monthly_cost","diff_monthly_cost","percentage_change_monthly_cost"]},"CostResourcesCollection":{"type":"array","items":{"$ref":"#/components/schemas/HarnessIacmCostResource"}},"HarnessIacmCostResource":{"type":"object","properties":{"current_monthly_cost":{"type":"string"},"diff_monthly_cost":{"type":"string"},"name":{"type":"string"},"percentage_change_monthly_cost":{"type":"integer","format":"int64"},"previous_monthly_cost":{"type":"string"},"subresources":{"type":"object","description":"List of subresources for a resource","additionalProperties":{"$ref":"#/components/schemas/HarnessIacmCostSubresource"}}},"description":"Cost of the given resource","required":["name","current_monthly_cost","previous_monthly_cost","diff_monthly_cost","percentage_change_monthly_cost"]},"HarnessIacmCostSubresource":{"type":"object","properties":{"current_monthly_cost":{"type":"string"},"diff_monthly_cost":{"type":"string"},"percentage_change_monthly_cost":{"type":"integer","format":"int64"},"previous_monthly_cost":{"type":"string"}},"description":"Cost of the given subresource","required":["current_monthly_cost","previous_monthly_cost","diff_monthly_cost","percentage_change_monthly_cost"]},"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```