Skip to content
Nexa Platform Docs

Get Service Metering

GET
/api/v1/usage/service-metering
curl --request GET \
  --url 'https://example.com/api/v1/usage/service-metering?start_date=2026-04-15T12%3A00%3A00Z&end_date=2026-04-15T12%3A00%3A00Z'

Get service metering history across all Snowflake services.

This endpoint queries METERING_HISTORY to provide comprehensive credit usage data across warehouses, serverless features, and other services.

Args: start_date: Start date for the query end_date: End date for the query service_type: Optional service type filter

Returns: ServiceMeteringResponse with service metering records

Raises: HTTPException: If query fails

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
start_date
required
Start Date

Start date for the query

string format: date-time

Start date for the query

end_date
required
End Date

End date for the query

string format: date-time

End date for the query

service_type
Any of:
string

Optional service type filter (e.g., WAREHOUSE_METERING, SNOWPIPE)

Header Parameters

Section titled “Header Parameters”
X-Environment-Id
Any of:
string

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

Media typeapplication/json
ServiceMeteringResponse

Response model for service metering history.

object
records
required
Records

List of service metering records

Array<object>
ServiceMeteringRecord

Service metering record model (from METERING_HISTORY).

object
start_time
required
Start Time

Start of the hour

string format: date-time
end_time
required
End Time

End of the hour

string format: date-time
service_type
required
Service Type

Type of service consuming credits

string
name
Any of:
string
credits_used
required
Credits Used

Total credits used

number
credits_used_compute
required
Credits Used Compute

Credits used for compute

number
credits_used_cloud_services
required
Credits Used Cloud Services

Credits used for cloud services

number
bytes_processed
Any of:
integer
rows_processed
Any of:
integer
total_credits
required
Total Credits

Total credits across all records

number
service_type
Any of:
string
start_date
required
Start Date

Query start date

string format: date-time
end_date
required
End Date

Query end date

string format: date-time
record_count
required
Record Count

Number of records

integer
Examplegenerated
{
  "records": [
    {
      "start_time": "2026-04-15T12:00:00Z",
      "end_time": "2026-04-15T12:00:00Z",
      "service_type": "example",
      "name": "example",
      "credits_used": 1,
      "credits_used_compute": 1,
      "credits_used_cloud_services": 1,
      "bytes_processed": 1,
      "rows_processed": 1
    }
  ],
  "total_credits": 1,
  "service_type": "example",
  "start_date": "2026-04-15T12:00:00Z",
  "end_date": "2026-04-15T12:00:00Z",
  "record_count": 1
}

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}