> 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/usage/show-usage.md).

# Show usage

Retrieve a single usage

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"usage","description":"Usage service handles licencing"}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/enforcement/client/usage/{metric}":{"put":{"tags":["usage"],"summary":"Show usage","description":"Retrieve a single usage","operationId":"usage#getUsage","parameters":[{"name":"accountIdentifier","in":"query","description":"Account identifier","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account identifier"}},{"name":"metric","in":"path","description":"Usage metric","required":true,"schema":{"type":"string","description":"Usage metric"}}],"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShowUsageResponse"}}}},"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":{"ShowUsageResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/UsageData"},"status":{"type":"string"}},"required":["status","data"]},"UsageData":{"type":"object","properties":{"ansible":{"$ref":"#/components/schemas/AnsibleUsageData"},"count":{"type":"integer","description":"Metric value (IACM successful applies)","format":"int64"}},"required":["count"]},"AnsibleUsageData":{"type":"object","properties":{"uniqueHosts30d":{"type":"integer","description":"Unique hosts with runs in last 30 days","format":"int64"}},"required":["uniqueHosts30d"]},"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"]}}}}
```