Get metrics about your orders and subscriptions.
Currency values are output in cents.
Scopes: metrics:read
package main
import(
"context"
"os"
polargo "github.com/polarsource/polar-go"
"github.com/polarsource/polar-go/types"
"github.com/polarsource/polar-go/models/components"
"github.com/polarsource/polar-go/models/operations"
"log"
)
func main() {
ctx := context.Background()
s := polargo.New(
polargo.WithSecurity(os.Getenv("POLAR_ACCESS_TOKEN")),
)
res, err := s.Metrics.Get(ctx, operations.MetricsGetRequest{
StartDate: types.MustDateFromString("2025-03-14"),
EndDate: types.MustDateFromString("2025-03-18"),
Interval: components.TimeIntervalHour,
OrganizationID: nil,
})
if err != nil {
log.Fatal(err)
}
if res.MetricsResponse != nil {
// handle response
}
}
{
"periods": [
{
"timestamp": "2023-11-07T05:31:56Z",
"orders": 123,
"revenue": 123,
"cumulative_revenue": 123,
"average_order_value": 123,
"one_time_products": 123,
"one_time_products_revenue": 123,
"new_subscriptions": 123,
"new_subscriptions_revenue": 123,
"renewed_subscriptions": 123,
"renewed_subscriptions_revenue": 123,
"active_subscriptions": 123,
"monthly_recurring_revenue": 123,
"checkouts": 123,
"succeeded_checkouts": 123,
"checkouts_conversion": 123
}
],
"totals": {
"orders": 123,
"revenue": 123,
"cumulative_revenue": 123,
"average_order_value": 123,
"one_time_products": 123,
"one_time_products_revenue": 123,
"new_subscriptions": 123,
"new_subscriptions_revenue": 123,
"renewed_subscriptions": 123,
"renewed_subscriptions_revenue": 123,
"active_subscriptions": 123,
"monthly_recurring_revenue": 123,
"checkouts": 123,
"succeeded_checkouts": 123,
"checkouts_conversion": 123
},
"metrics": {
"orders": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"revenue": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"cumulative_revenue": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"average_order_value": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"one_time_products": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"one_time_products_revenue": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"new_subscriptions": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"new_subscriptions_revenue": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"renewed_subscriptions": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"renewed_subscriptions_revenue": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"active_subscriptions": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"monthly_recurring_revenue": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"checkouts": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"succeeded_checkouts": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"checkouts_conversion": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
}
}
}
You can generate an Organization Access Token from your organization's settings.
Start date.
End date.
Timezone to use for the timestamps. Default is UTC.
1
Interval between two timestamps.
year
, month
, week
, day
, hour
Filter by organization ID. The organization ID.
"1dbfc517-0bbf-4301-9ba8-555ca42b9737"
Filter by product ID. The product ID.
Filter by billing type. recurring
will filter data corresponding to subscriptions creations or renewals. one_time
will filter data corresponding to one-time purchases.
one_time
, recurring
Filter by customer ID. The customer ID.
Successful Response
Metrics response schema.
Was this page helpful?
package main
import(
"context"
"os"
polargo "github.com/polarsource/polar-go"
"github.com/polarsource/polar-go/types"
"github.com/polarsource/polar-go/models/components"
"github.com/polarsource/polar-go/models/operations"
"log"
)
func main() {
ctx := context.Background()
s := polargo.New(
polargo.WithSecurity(os.Getenv("POLAR_ACCESS_TOKEN")),
)
res, err := s.Metrics.Get(ctx, operations.MetricsGetRequest{
StartDate: types.MustDateFromString("2025-03-14"),
EndDate: types.MustDateFromString("2025-03-18"),
Interval: components.TimeIntervalHour,
OrganizationID: nil,
})
if err != nil {
log.Fatal(err)
}
if res.MetricsResponse != nil {
// handle response
}
}
{
"periods": [
{
"timestamp": "2023-11-07T05:31:56Z",
"orders": 123,
"revenue": 123,
"cumulative_revenue": 123,
"average_order_value": 123,
"one_time_products": 123,
"one_time_products_revenue": 123,
"new_subscriptions": 123,
"new_subscriptions_revenue": 123,
"renewed_subscriptions": 123,
"renewed_subscriptions_revenue": 123,
"active_subscriptions": 123,
"monthly_recurring_revenue": 123,
"checkouts": 123,
"succeeded_checkouts": 123,
"checkouts_conversion": 123
}
],
"totals": {
"orders": 123,
"revenue": 123,
"cumulative_revenue": 123,
"average_order_value": 123,
"one_time_products": 123,
"one_time_products_revenue": 123,
"new_subscriptions": 123,
"new_subscriptions_revenue": 123,
"renewed_subscriptions": 123,
"renewed_subscriptions_revenue": 123,
"active_subscriptions": 123,
"monthly_recurring_revenue": 123,
"checkouts": 123,
"succeeded_checkouts": 123,
"checkouts_conversion": 123
},
"metrics": {
"orders": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"revenue": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"cumulative_revenue": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"average_order_value": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"one_time_products": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"one_time_products_revenue": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"new_subscriptions": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"new_subscriptions_revenue": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"renewed_subscriptions": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"renewed_subscriptions_revenue": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"active_subscriptions": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"monthly_recurring_revenue": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"checkouts": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"succeeded_checkouts": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
},
"checkouts_conversion": {
"slug": "<string>",
"display_name": "<string>",
"type": "scalar"
}
}
}