> ## Documentation Index > Fetch the complete documentation index at: https://docs.contraforce.com/llms.txt > Use this file to discover all available pages before exploring further. # Get reporting value ## OpenAPI ````yaml /api-reference/openapi.json post /api/v2/reporting/value openapi: 3.1.1 info: title: ContraForce API description: ContraForce platform API for security operations management. version: '2.0' servers: [] security: [] tags: - name: Incidents - name: Gamebooks - name: Data sources - name: Service tickets - name: Investigation - name: Export - name: agent-tools - name: Cross-workspace incidents - name: Cross-workspace gamebooks - name: Cross-workspace data sources - name: Webhooks - name: Service accounts - name: Users - name: Azure resources - name: Reporting paths: /api/v2/reporting/value: post: tags: - Reporting summary: Get reporting value operationId: v2-get-reporting-value requestBody: content: application/json: schema: $ref: '#/components/schemas/ReportingReadRequest' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ApiResponseOfValueReportResponse' '400': description: Bad request — validation or parameter binding failed. content: application/problem+json: schema: $ref: '#/components/schemas/ApiProblemDetails' '401': description: Unauthorized — missing or invalid Bearer token. content: application/problem+json: schema: $ref: '#/components/schemas/ApiProblemDetails' '403': description: Forbidden — insufficient scope or workspace access. content: application/problem+json: schema: $ref: '#/components/schemas/ApiProblemDetails' '404': description: Not found — workspace or resource is missing. content: application/problem+json: schema: $ref: '#/components/schemas/ApiProblemDetails' '500': description: Internal server error. content: application/problem+json: schema: $ref: '#/components/schemas/ApiProblemDetails' components: schemas: ReportingReadRequest: required: - from - to type: object properties: from: type: string description: >- The first day of the range, inclusive (UTC days). A range spans at most 366 days. format: date to: type: string description: The last day of the range, inclusive (UTC days). format: date workspaceIds: type: - 'null' - array items: type: string format: uuid description: >- The workspaces to read, at most 500; `null` or empty reads every workspace the caller may see. A service account sees the workspaces it holds a role on. description: The day range and workspace selection every reporting read takes. ApiResponseOfValueReportResponse: type: object properties: data: $ref: '#/components/schemas/ValueReportResponse' description: v2 agent cost against the analyst time it saved. meta: $ref: '#/components/schemas/ResponseMeta' description: Standard v2 API response envelope for single-item responses. ApiProblemDetails: type: object properties: type: type: - 'null' - string title: type: - 'null' - string status: pattern: ^-?(?:0|[1-9]\d*)$ type: - 'null' - integer - string format: int32 detail: type: - 'null' - string instance: type: - 'null' - string code: type: - 'null' - string requestId: type: - 'null' - string timestamp: type: - 'null' - string target: type: - 'null' - string errors: type: - 'null' - object additionalProperties: type: array items: type: string description: >- API extension of ProblemDetails that surfaces the stable error code, trace identifier, timestamp, optional target, and optional field-keyed validation error map alongside the RFC 7807 members. ValueReportResponse: type: object properties: runs: pattern: ^-?(?:0|[1-9]\d*)$ type: - integer - string description: >- Every terminal run in the range, retries and failures included. Activity, not spend. format: int32 billableRuns: pattern: ^-?(?:0|[1-9]\d*)$ type: - integer - string description: >- The runs a metered plan is charged for; fewer than int ValueReportResponse.Runs when an attempt failed. format: int32 incidentsInvestigated: pattern: ^-?(?:0|[1-9]\d*)$ type: - integer - string description: Incidents whose latest run reached a terminal outcome. format: int32 resolvedByAgent: pattern: ^-?(?:0|[1-9]\d*)$ type: - integer - string description: >- Incidents the agent resolved outright, the only ones counted as analyst work saved. format: int32 costUsd: pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$ type: - 'null' - number - string description: What the range cost, or `null` when no cost can be attributed. format: double costBasis: type: - 'null' - string description: >- Which number decimal? ValueReportResponse.CostUsd is: `Billed` for runs times the metered price, `Compute` for the agent's own spend, or `None` while nothing is being charged. unitPriceUsd: pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$ type: - 'null' - number - string description: >- The discount-adjusted price per investigation a metered plan is charged; `null` on any other basis. format: double totalTokens: pattern: ^-?(?:0|[1-9]\d*)$ type: - 'null' - integer - string description: >- Tokens the runs consumed, only where the compute spend is the caller's own: priced at a model's rate, they are ContraForce's cost on a metered plan. format: int64 read: $ref: '#/components/schemas/ReportingReadInfoResponse' description: How the response was read. description: v2 agent cost against the analyst time it saved. ResponseMeta: type: object properties: requestId: type: - 'null' - string timestamp: type: - 'null' - string ReportingReadInfoResponse: type: object properties: scope: type: - 'null' - string description: >- `account` when account-wide totals were read, otherwise `workspaces`. workspaceCount: pattern: ^-?(?:0|[1-9]\d*)$ type: - integer - string description: Workspaces the response covers. format: int32 documentsRead: pattern: ^-?(?:0|[1-9]\d*)$ type: - integer - string description: >- Aggregate documents read to build the response (0 when served from cache). format: int32 fromCache: type: boolean description: Whether the response came from the in-memory cache. authorizeMs: pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$ type: - number - string description: >- Milliseconds this request spent validating the range and checking workspace access. format: double readMs: pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$ type: - number - string description: >- Milliseconds spent loading aggregate documents (0 when served from cache). format: double description: How a reporting response was read, for load testing and diagnosis. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.