# Get usage terms v2 - Checkly Docs > List all usage terms, optionally filtered by inclusive UTC dates. Results are live and paginated. Source: https://www.checklyhq.com/docs/api-reference/usage/get-usage-terms-and-accounts-for-the-current-organization/ --- Get usage terms ``` curl --request GET \ --url https://api.checklyhq.com/v2/usage/terms \ --header 'Authorization: Bearer ' ``` ``` import requests url = "https://api.checklyhq.com/v2/usage/terms" headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers) print(response.text) ``` ``` const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; fetch('https://api.checklyhq.com/v2/usage/terms', options) .then(res => res.json()) .then(res => console.log(res)) .catch(err => console.error(err)); ``` ``` "https://api.checklyhq.com/v2/usage/terms", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "GET", CURLOPT_HTTPHEADER => [ "Authorization: Bearer " ], ]); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; } ``` ``` package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.checklyhq.com/v2/usage/terms" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(string(body)) } ``` ``` HttpResponse response = Unirest.get("https://api.checklyhq.com/v2/usage/terms") .header("Authorization", "Bearer ") .asString(); ``` ``` require 'uri' require 'net/http' url = URI("https://api.checklyhq.com/v2/usage/terms") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ``` { "data": [ { "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "name": " ", "accounts": [ { "id": " ", "name": " " } ], "contractStartDate": "2023-12-25", "contractEndDate": "2023-12-25", "usageStartDate": "2023-12-25", "creditBudget": 1, "standardCreditsPerUnit": 1, "premiumCreditsPerUnit": 1, "packageModel": "limits", "pricingRules": { "apiChecks": { "method": "per_unit", "quantity": 1, "unit": " ", "credits": 1, "rates": [ { "when": " ", "credits": 1 } ], "included": { "quantity": 1, "period": " " } }, "multistepChecks": { "method": "per_unit", "quantity": 1, "unit": " ", "credits": 1, "rates": [ { "when": " ", "credits": 1 } ], "included": { "quantity": 1, "period": " " } }, "browserChecks": { "method": "per_unit", "quantity": 1, "unit": " ", "credits": 1, "rates": [ { "when": " ", "credits": 1 } ], "included": { "quantity": 1, "period": " " } }, "playwrightCheckSuites": { "method": "per_unit", "quantity": 1, "unit": " ", "credits": 1, "rates": [ { "when": " ", "credits": 1 } ], "included": { "quantity": 1, "period": " " } }, "uptimeMonitors": { "method": "per_unit", "quantity": 1, "unit": " ", "credits": 1, "rates": [ { "when": " ", "credits": 1 } ], "included": { "quantity": 1, "period": " " } }, "aiInvocations": { "method": "per_unit", "quantity": 1, "unit": " ", "credits": 1, "rates": [ { "when": " ", "credits": 1 } ], "included": { "quantity": 1, "period": " " } }, "statusPages": { "method": "per_unit", "quantity": 1, "unit": " ", "credits": 1, "rates": [ { "when": " ", "credits": 1 } ], "included": { "quantity": 1, "period": " " } }, "statusPageAdditionalServices": { "method": "per_unit", "quantity": 1, "unit": " ", "credits": 1, "rates": [ { "when": " ", "credits": 1 } ], "included": { "quantity": 1, "period": " " } }, "statusPageAdditionalSubscribers": { "method": "per_unit", "quantity": 1, "unit": " ", "credits": 1, "rates": [ { "when": " ", "credits": 1 } ], "included": { "quantity": 1, "period": " " } }, "additionalSms": { "method": "per_unit", "quantity": 1, "unit": " ", "credits": 1, "rates": [ { "when": " ", "credits": 1 } ], "included": { "quantity": 1, "period": " " } }, "additionalPhoneAlerts": { "method": "per_unit", "quantity": 1, "unit": " ", "credits": 1, "rates": [ { "when": " ", "credits": 1 } ], "included": { "quantity": 1, "period": " " } } } } ], "nextId": " " } ``` ``` { "statusCode": 123, "error": " ", "message": " ", "code": "ACCOUNT_NOT_IN_USAGE_TERMS" } ``` ``` { "statusCode": 123, "error": " ", "message": " ", "code": "ACCOUNT_NOT_IN_USAGE_TERMS" } ``` ``` { "statusCode": 123, "error": " ", "message": " ", "code": "ACCOUNT_NOT_IN_USAGE_TERMS" } ``` ``` { "statusCode": 123, "error": " ", "message": " ", "code": "ACCOUNT_NOT_IN_USAGE_TERMS" } ``` ``` { "statusCode": 123, "error": " ", "message": " ", "code": "ACCOUNT_NOT_IN_USAGE_TERMS" } ``` ``` { "statusCode": 123, "error": " ", "message": " ", "code": "ACCOUNT_NOT_IN_USAGE_TERMS" } ``` ``` { "statusCode": 123, "error": " ", "message": " ", "code": "ACCOUNT_NOT_IN_USAGE_TERMS" } ``` Usage # Get usage terms v2 List all usage terms, optionally filtered by inclusive UTC dates. Results are live and paginated. GET / v2 / usage / terms Get usage terms ``` curl --request GET \ --url https://api.checklyhq.com/v2/usage/terms \ --header 'Authorization: Bearer ' ``` ``` import requests url = "https://api.checklyhq.com/v2/usage/terms" headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers) print(response.text) ``` ``` const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; fetch('https://api.checklyhq.com/v2/usage/terms', options) .then(res => res.json()) .then(res => console.log(res)) .catch(err => console.error(err)); ``` ``` "https://api.checklyhq.com/v2/usage/terms", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "GET", CURLOPT_HTTPHEADER => [ "Authorization: Bearer " ], ]); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; } ``` ``` package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.checklyhq.com/v2/usage/terms" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(string(body)) } ``` ``` HttpResponse response = Unirest.get("https://api.checklyhq.com/v2/usage/terms") .header("Authorization", "Bearer ") .asString(); ``` ``` require 'uri' require 'net/http' url = URI("https://api.checklyhq.com/v2/usage/terms") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ``` { "data": [ { "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "name": " ", "accounts": [ { "id": " ", "name": " " } ], "contractStartDate": "2023-12-25", "contractEndDate": "2023-12-25", "usageStartDate": "2023-12-25", "creditBudget": 1, "standardCreditsPerUnit": 1, "premiumCreditsPerUnit": 1, "packageModel": "limits", "pricingRules": { "apiChecks": { "method": "per_unit", "quantity": 1, "unit": " ", "credits": 1, "rates": [ { "when": " ", "credits": 1 } ], "included": { "quantity": 1, "period": " " } }, "multistepChecks": { "method": "per_unit", "quantity": 1, "unit": " ", "credits": 1, "rates": [ { "when": " ", "credits": 1 } ], "included": { "quantity": 1, "period": " " } }, "browserChecks": { "method": "per_unit", "quantity": 1, "unit": " ", "credits": 1, "rates": [ { "when": " ", "credits": 1 } ], "included": { "quantity": 1, "period": " " } }, "playwrightCheckSuites": { "method": "per_unit", "quantity": 1, "unit": " ", "credits": 1, "rates": [ { "when": " ", "credits": 1 } ], "included": { "quantity": 1, "period": " " } }, "uptimeMonitors": { "method": "per_unit", "quantity": 1, "unit": " ", "credits": 1, "rates": [ { "when": " ", "credits": 1 } ], "included": { "quantity": 1, "period": " " } }, "aiInvocations": { "method": "per_unit", "quantity": 1, "unit": " ", "credits": 1, "rates": [ { "when": " ", "credits": 1 } ], "included": { "quantity": 1, "period": " " } }, "statusPages": { "method": "per_unit", "quantity": 1, "unit": " ", "credits": 1, "rates": [ { "when": " ", "credits": 1 } ], "included": { "quantity": 1, "period": " " } }, "statusPageAdditionalServices": { "method": "per_unit", "quantity": 1, "unit": " ", "credits": 1, "rates": [ { "when": " ", "credits": 1 } ], "included": { "quantity": 1, "period": " " } }, "statusPageAdditionalSubscribers": { "method": "per_unit", "quantity": 1, "unit": " ", "credits": 1, "rates": [ { "when": " ", "credits": 1 } ], "included": { "quantity": 1, "period": " " } }, "additionalSms": { "method": "per_unit", "quantity": 1, "unit": " ", "credits": 1, "rates": [ { "when": " ", "credits": 1 } ], "included": { "quantity": 1, "period": " " } }, "additionalPhoneAlerts": { "method": "per_unit", "quantity": 1, "unit": " ", "credits": 1, "rates": [ { "when": " ", "credits": 1 } ], "included": { "quantity": 1, "period": " " } } } } ], "nextId": " " } ``` ``` { "statusCode": 123, "error": " ", "message": " ", "code": "ACCOUNT_NOT_IN_USAGE_TERMS" } ``` ``` { "statusCode": 123, "error": " ", "message": " ", "code": "ACCOUNT_NOT_IN_USAGE_TERMS" } ``` ``` { "statusCode": 123, "error": " ", "message": " ", "code": "ACCOUNT_NOT_IN_USAGE_TERMS" } ``` ``` { "statusCode": 123, "error": " ", "message": " ", "code": "ACCOUNT_NOT_IN_USAGE_TERMS" } ``` ``` { "statusCode": 123, "error": " ", "message": " ", "code": "ACCOUNT_NOT_IN_USAGE_TERMS" } ``` ``` { "statusCode": 123, "error": " ", "message": " ", "code": "ACCOUNT_NOT_IN_USAGE_TERMS" } ``` ``` { "statusCode": 123, "error": " ", "message": " ", "code": "ACCOUNT_NOT_IN_USAGE_TERMS" } ``` #### Authorizations ​ Authorization string header required The Checkly Public API uses API keys to authenticate requests. You can get the API Key [here](https://app.checklyhq.com/settings/user/api-keys). Your API key is like a password: keep it secure! Authentication to the API is performed using the Bearer auth method in the Authorization header and using the account ID. For example, set Authorization header while using cURL: `curl -H "Authorization: Bearer [apiKey]" "X-Checkly-Account: [accountId]"` #### Headers ​ x-checkly-account string Your Checkly account ID, you can find it at [https://app.checklyhq.com/settings/account/general](https://app.checklyhq.com/settings/account/general) #### Query Parameters ​ from string Include terms ending on or after this UTC date. No lower bound by default. ​ to string Include terms starting on or before this UTC date. No upper bound by default. ​ limit integer default: 100 Required range: `1 ​ nextId string Query-bound cursor. Live reads do not freeze measurements or prices. Required string length: `1 - 4096` #### Response Successful ​ data object[] required Show child attributes ​ nextId string | null required Was this page helpful? [Suggest edits](https://github.com/checkly/docs/edit/main/api-reference/usage/get-usage-terms-and-accounts-for-the-current-organization.mdx)[Raise issue](https://github.com/checkly/docs/issues/new?title=Issue%20on%20docs&body=Path:%20/api-reference/usage/get-usage-terms-and-accounts-for-the-current-organization) [Usage API Previous](https://www.checklyhq.com/docs/api-reference/usage/overview)[Get usage series v2 Next](https://www.checklyhq.com/docs/api-reference/usage/get-paginated-consumption-across-usage-terms-group-by-account-usage-term-pricing-rule-and-check-type) [x](https://x.com/checklyhq)[github](https://github.com/checkly)[linkedin](https://linkedin.com/company/checkly) [Powered by This documentation is built and hosted on Mintlify, a developer documentation platform](https://www.mintlify.com/?utm_campaign=poweredBy&utm_medium=referral&utm_source=checkly-422f444a)