---
title: "Retrieve location for a user as a time series."
method: GET
path: "/data/v0/{fulcra_userid}/location_time_series"
tags: ["data"]
---

# Retrieve location for a user as a time series.

`GET /data/v0/{fulcra_userid}/location_time_series`

## Request

- Base URL: `https://api.fulcradynamics.com`
- URL: `https://api.fulcradynamics.com/data/v0/{fulcra_userid}/location_time_series`
- Auth: HTTP bearer

Retrieve a time series of locations that the user was at.

## Path parameters

- `fulcra_userid` string, uuid, required

## Query parameters

- `start_time` string, date-time, required: The starting timestamp in ISO8601 format (inclusive)
- `end_time` string, date-time, required: The ending timestamp in ISO8601 format (exclusive)
- `sample_rate` integer: The sample rate in seconds.
- `look_back` integer: The number of seconds in the past to look back for a sample.
- `change_meters` number, nullable: When specified, subsequent samples that are fewer than this many meters away will not be included.
- `reverse_geocode` boolean: When true, Fulcra will attempt to reverse geocode the locations and include the location details in the results.
- `location_sources` LocationSampleSource[]: A set of sources to use location samples from.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fulcradynamics/apis/fulcra-life-api.md) · [All operations](https://skmtc.dev/fulcradynamics/apis/fulcra-life-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fulcradynamics/apis/fulcra-life-api/revisions/d85136fc304a?raw)
