curl --request GET \
--url https://api.relay.link/metrics/usageconst options = {method: 'GET'};
fetch('https://api.relay.link/metrics/usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.relay.link/metrics/usage"
response = requests.get(url)
print(response.text){
"metrics": [
{
"apiKey": "<string>",
"apiKeyId": "<string>",
"appId": "<string>",
"timestamp": "<string>",
"endpoint": "<string>",
"statusCode": 123,
"errorCode": "<string>",
"count": 123
}
]
}Get Usage
Get API call counts for the authenticated API key, or for owned keys and Apps when using x-dev-portal-key. Rows are grouped by API key, endpoint, status code, and error code.
curl --request GET \
--url https://api.relay.link/metrics/usageconst options = {method: 'GET'};
fetch('https://api.relay.link/metrics/usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.relay.link/metrics/usage"
response = requests.get(url)
print(response.text){
"metrics": [
{
"apiKey": "<string>",
"apiKeyId": "<string>",
"appId": "<string>",
"timestamp": "<string>",
"endpoint": "<string>",
"statusCode": 123,
"errorCode": "<string>",
"count": 123
}
]
}Headers
Integrator portal credential required for appId filtering.
Integrator API key.
Query Parameters
Time bucket granularity. minutely defaults to last 24h, hourly to last 7d, daily to last 14d.
minutely, hourly, daily Start of the query window as a Unix timestamp (seconds). Defaults based on granularity.
End of the query window as a Unix timestamp (seconds). Defaults to now.
Filter metrics by API key. Accepts a single value or a comma-separated list (e.g. key1,key2) — results include metrics matching any of the supplied keys. Maximum 50 values across apiKey, apiKeyId and appId.
Filter metrics by API key IDs (key_id_, comma-separated) owned by your integrator when using x-dev-portal-key. OR matching with apiKey and appId; maximum 50 values combined.
Filter by owned Apps (app_id_, comma-separated); requires x-dev-portal-key. Includes all current keys, including inactive keys. OR matching with apiKey and apiKeyId; maximum 50 filter values combined before expanding Apps to keys. Rows remain grouped by API key. App attribution is resolved at read time: hard-deleted keys drop out and reassigned keys attribute all retained usage to their current App. Retention is 24h minutely, 7d hourly, and 14d daily.
Response
Default Response
Show child attributes
Show child attributes
Was this page helpful?