Analytics
Get organization usage
Returns daily usage data aggregated across all projects in the organization.
At a glance
| Item | Value |
|---|---|
| Method | GET |
| Path | /v1/organizations/{org_id}/usage |
| Auth | Authorization: Bearer <token-or-api-key> |
Quick request
Use this as a starting point. Replace the placeholder IDs and set PGBEAM_TOKEN if the endpoint requires auth.
curl -X GET \
"$PGBEAM_API_URL/v1/organizations/<org_id>/usage" \
-H "Authorization: Bearer $PGBEAM_TOKEN"AuthorizationBearer <token>
JWT issued by Better Auth. Verified via JWKS.
In: header
Path Parameters
org_id*string
Unique organization identifier.
Match
^[a-zA-Z0-9_.-]+$Query Parameters
start_date*string
Start date (inclusive, YYYY-MM-DD).
Format
dateend_date*string
End date (inclusive, YYYY-MM-DD).
Format
dateResponse Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.pgbeam.com/v1/organizations/string/usage?start_date=2019-08-24&end_date=2019-08-24"{
"usage": [
{
"day": "2019-08-24",
"queries_total": 0,
"cache_hits": 0,
"cache_misses": 0,
"connection_seconds": 0,
"bytes_transferred": 0
}
]
}{
"error": {
"code": "string",
"message": "string"
}
}{
"error": {
"code": "string",
"message": "string"
}
}{
"error": {
"code": "string",
"message": "string"
}
}{
"error": {
"code": "string",
"message": "string"
}
}