# List usage thresholds

> Lists the usage alert thresholds the caller can access, optionally filtered by project_id. Each threshold fires the `usage.threshold_crossed` webhook when a project's cost or token usage over a calendar-month or rolling-24h window crosses the configured value.

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"List usage thresholds"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/api/v1/usage/thresholds"}
  context={"endpoint"}
>
  
</MethodEndpoint>

Lists the usage alert thresholds the caller can access, optionally filtered by project_id. Each threshold fires the `usage.threshold_crossed` webhook when a project's cost or token usage over a calendar-month or rolling-24h window crosses the configured value.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
>
  <Translate id="theme.openapi.request.title">Request</Translate>
</Heading>

<ParamsDetails
  {...require("./list-usage-thresholds.ParamsDetails.json")}
>
  
</ParamsDetails>

<RequestSchema
  {...require("./list-usage-thresholds.RequestSchema.json")}
>
  
</RequestSchema>

<StatusCodes
  {...require("./list-usage-thresholds.StatusCodes.json")}
>
  
</StatusCodes>