> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinetica.com/llms.txt
> Use this file to discover all available pages before exploring further.

# get_records_by_series

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/get_records_by_series.rs#L47-L62)
pub async fn [get\_records\_by\_series](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/get-records-by-series.md#method.get_records_by_series)\<R: [RetrievedRecord](https://docs.kinetica.com/content/api/rust/record_retriever/trait.RetrievedRecord.md)>( \&self, table\_name: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), world\_table\_name: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), offset: [i32](https://doc.rust-lang.org/1.98.1/std/primitive.i32.html), limit: [i32](https://doc.rust-lang.org/1.98.1/std/primitive.i32.html), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[GetRecordsBySeriesResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.GetRecordsBySeriesResponse.md)\<R>, [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Retrieve the complete series/track records from partial track informationRetrieves the complete series/track records from the given `world_table_name` based on the partial track information contained in the `table_name`.This operation supports paging through the data via the `offset` and `limit` parameters.In contrast to `/get/records` this returns records grouped by series/track. So if `offset` is 0 and `limit` is 5 this operation would return the first 5 series/tracks in `table_name`. Each series/track will be returned sorted by their TIMESTAMP column.The records are decoded by the types the server names, as known to this client or else read from the server.

##### Arguments

<ul>
  <li>`table_name` - Name of the table or view for which series/tracks will be fetched, in \[schema\_name.]table\_name format, using standard name resolution rules.</li>
  <li>`world_table_name` - Name of the table containing the complete series/track information to be returned for the tracks present in the `table_name`, in \[schema\_name.]table\_name format, using standard name resolution rules. Typically this is used when retrieving series/tracks from a view (which contains partial series/tracks) but the user wants to retrieve the entire original series/tracks. Can be blank.</li>
  <li>`offset` - A positive integer indicating the number of initial series/tracks to skip (useful for paging through the results).</li>
  <li>`limit` - A positive integer indicating the maximum number of series/tracks to be returned. Or END\_OF\_SET (-9999) to indicate that the max number of results should be returned.</li>
</ul>

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/get_records_by_series.rs#L101-L126)
pub async fn [get\_records\_by\_series\_with\_opts](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/get-records-by-series.md#method.get_records_by_series_with_opts)\<R: [RetrievedRecord](https://docs.kinetica.com/content/api/rust/record_retriever/trait.RetrievedRecord.md)>( \&self, table\_name: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), world\_table\_name: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), offset: [i32](https://doc.rust-lang.org/1.98.1/std/primitive.i32.html), limit: [i32](https://doc.rust-lang.org/1.98.1/std/primitive.i32.html), options: [GetRecordsBySeriesRequestOptions](https://docs.kinetica.com/content/api/rust/generated/api/struct.GetRecordsBySeriesRequestOptions.md), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[GetRecordsBySeriesResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.GetRecordsBySeriesResponse.md)\<R>, [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Retrieve the complete series/track records from partial track informationRetrieves the complete series/track records from the given `world_table_name` based on the partial track information contained in the `table_name`.This operation supports paging through the data via the `offset` and `limit` parameters.In contrast to `/get/records` this returns records grouped by series/track. So if `offset` is 0 and `limit` is 5 this operation would return the first 5 series/tracks in `table_name`. Each series/track will be returned sorted by their TIMESTAMP column.The records are decoded by the types the server names, as known to this client or else read from the server.

##### Arguments

<ul>
  <li>`table_name` - Name of the table or view for which series/tracks will be fetched, in \[schema\_name.]table\_name format, using standard name resolution rules.</li>
  <li>`world_table_name` - Name of the table containing the complete series/track information to be returned for the tracks present in the `table_name`, in \[schema\_name.]table\_name format, using standard name resolution rules. Typically this is used when retrieving series/tracks from a view (which contains partial series/tracks) but the user wants to retrieve the entire original series/tracks. Can be blank.</li>
  <li>`offset` - A positive integer indicating the number of initial series/tracks to skip (useful for paging through the results).</li>
  <li>`limit` - A positive integer indicating the maximum number of series/tracks to be returned. Or END\_OF\_SET (-9999) to indicate that the max number of results should be returned.</li>
  <li>`options` - The optional parameters; any left unset take the server’s defaults.</li>
</ul>

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/get_records_by_series.rs#L196-L218)
pub async fn [get\_records\_by\_series\_request](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/get-records-by-series.md#method.get_records_by_series_request)\<R: [RetrievedRecord](https://docs.kinetica.com/content/api/rust/record_retriever/trait.RetrievedRecord.md)>( \&self, request: &[GetRecordsBySeriesRequest](https://docs.kinetica.com/content/api/rust/generated/api/struct.GetRecordsBySeriesRequest.md), record\_type: [Option](https://doc.rust-lang.org/1.98.1/core/option/enum.Option.html)\<&[Arc](https://doc.rust-lang.org/1.98.1/alloc/sync/struct.Arc.html)\<[Type](https://docs.kinetica.com/content/api/rust/generic_record/struct.Type.md)>>, ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[GetRecordsBySeriesResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.GetRecordsBySeriesResponse.md)\<R>, [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Sends a pre-built [`GetRecordsBySeriesRequest`](https://docs.kinetica.com/content/api/rust/generated/api/struct.GetRecordsBySeriesRequest) to the `/get/records/byseries` endpoint and decodes the records it returns, by `record_type` if given, else by the types the server names. Only binary encoding is supported.

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/get_records_by_series.rs#L222-L233)
pub async fn [get\_records\_by\_series\_raw](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/get-records-by-series.md#method.get_records_by_series_raw)( \&self, request: &[GetRecordsBySeriesRequest](https://docs.kinetica.com/content/api/rust/generated/api/struct.GetRecordsBySeriesRequest.md), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[RawGetRecordsBySeriesResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.RawGetRecordsBySeriesResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Sends a pre-built [`GetRecordsBySeriesRequest`](https://docs.kinetica.com/content/api/rust/generated/api/struct.GetRecordsBySeriesRequest) to the `/get/records/byseries` endpoint, returning the response as the server sends it.

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/get_records_by_series.rs#L237-L249)
pub async fn [get\_records\_by\_series\_from\_url](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/get-records-by-series.md#method.get_records_by_series_from_url)( \&self, url: &[str](https://doc.rust-lang.org/1.98.1/std/primitive.str.html), request: &[GetRecordsBySeriesRequest](https://docs.kinetica.com/content/api/rust/generated/api/struct.GetRecordsBySeriesRequest.md), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[RawGetRecordsBySeriesResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.RawGetRecordsBySeriesResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Sends a pre-built [`GetRecordsBySeriesRequest`](https://docs.kinetica.com/content/api/rust/generated/api/struct.GetRecordsBySeriesRequest) to a specific worker URL, bypassing HA head-node selection. Used for multi-head access.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.