v1
public

List Public Batteries

Unauthenticated curated-battery list, paged and licensed like /motors.

Numeric fields are filterable with bracket syntax — ?kv[gte]=900&kv[lte]=1100 — and the bounds are inclusive. Discrete fields take [in] with a comma-separated list — ?brand[in]=T-Motor,Hobbywing. A bracket filter naming a field this type does not have is a 400 unknown_filter listing the fields it does have, so a typo cannot quietly return the whole catalog.

Carries license because there is no bulk export: a consumer reading the open database page by page has to learn the terms from the response, and this is the only place left that can tell it.

get/v1/public/batteries

Request

  • Base URL: https://thrustlab.com
  • URL: https://thrustlab.com/v1/public/batteries
  • Auth: none required

Query parameters

limitinteger
starting_afterstring nullable

Where the next page starts — the next_starting_after the previous page returned. Under the default ordering (sort_by=name, sort_order=asc) that is the last component's id, and a component id is accepted under any ordering. Under any other ordering it is an opaque cursor bound to that sort_by/sort_order, and replaying it against a different ordering is a 400 invalid_cursor. Omit for the first page.

searchstring nullable

Case-insensitive substring match on the component name.

qstring nullable

Alias for search. If both are supplied, search wins. Length-capped identically.

brandstring[] nullable

Restrict to these brands. Repeat the parameter for several (?brand=T-Motor&brand=Hobbywing). brand[in]=a,b does the same.

sort_bystring

Sort key. name (the default) on every type, plus — motor: R (or resistance), iq_max (or current_max), kv, n (or poles), weight; battery: c_rating, energy_density, series_cells, total_capacity_mAh (or capacity), weight_g (or weight); propeller: diameter, inertia, maxRPM (or max_rpm), num_blades, pd_ratio, pitch, weight. Either spelling of a field works, here and in the bracket filters. pd_ratio is a propeller's pitch divided by its diameter; energy_density is a pack's NOMINAL specific energy in Wh/kg (capacity x 3.7 V per cell x series cells / mass), a label figure for ranking packs against each other, not a measurement.

sort_orderstring

asc or desc.

Response

Successful Response

has_moreboolean required

True when a further page exists; page with starting_after.

licensestring required

The licence this data is published under. Stated on the response because there is no bulk export to carry it.

next_starting_afterstring nullable

Pass as starting_after to fetch the next page. Null on the last page, so a client can loop until it disappears. Under the default ordering it is the last component's id; under any other ordering it is an opaque cursor bound to that sort.

object'list'

Changes

No recorded changes to this operation across all 1 revision of this API.