Recharge Endpoint

polar_flow.endpoints.recharge.RechargeEndpoint

Nightly recharge endpoint for recovery data.

Provides access to ANS (Autonomic Nervous System) charge and recovery metrics. Data is available for the last 28 days.

__init__(client)

Initialize recharge endpoint.

Parameters:

Name	Type	Description	Default
client	PolarFlow	PolarFlow client instance	required

get(date) async

Get nightly recharge data for a specific date.

Parameters:

Name	Type	Description	Default
date	str	Date in YYYY-MM-DD format	required

Returns:

Type	Description
NightlyRecharge	Nightly recharge recovery data

Raises:

Type	Description
NotFoundError	If no recharge data exists for the date
ValidationError	If date format is invalid

list(*, since=None) async

List nightly recharge data for the last 28 days.

Parameters:

Name	Type	Description	Default
since	str | None	Filter results to only include data since this date (YYYY-MM-DD). If not specified, returns all available data (max 28 days).	None

Returns:

Type	Description
list[NightlyRecharge]	List of nightly recharge data

Raises:

Type	Description
ValueError	If since date format is invalid

Example

async with PolarFlow(access_token="token") as client:
    # Get all available recharge data (last 28 days)
    recharge = await client.recharge.list()

    # Get recharge data since specific date
    recharge = await client.recharge.list(since="2026-01-01")

    for r in recharge:
        print(f"{r.date}: ANS charge {r.ans_charge}")