---
title: Referencing Saved Locations via API
description: This article provides information on how to reference saved locations via the API.
---

[Skip to content](https://support.tive.com/en-us/referencing-saved-locations-via-api#main-content)

- [English - United States](https://support.tive.com/en-us/referencing-saved-locations-via-api)
- [Español](https://support.tive.com/es/referencing-saved-locations-via-api)

English - United States

Show submenu for translations

[![TIVE logo](https://support.tive.com/hubfs/612cb18878946b6233874e2a_tive-logo-light-1.svg)](https://new.support.tive.com/?hsLang=en-us)

- [Home](https://support.tive.com/)
- [API Support](https://developers.tive.com/docs/rest-api-overview)
- [Documents & Certificates](https://new.support.tive.com/documents-and-certificates)
- [Tive Platform](http://platform.tive.com/)
- [What's New](https://new.support.tive.com/product-release-notes)

Open main navigation

Close main navigation

- [Home](https://support.tive.com/)
- [API Support](https://developers.tive.com/docs/rest-api-overview)
- [Documents & Certificates](https://new.support.tive.com/documents-and-certificates)
- [Tive Platform](http://platform.tive.com/)
- [What's New](https://new.support.tive.com/product-release-notes)
- - [English - United States](https://support.tive.com/en-us/referencing-saved-locations-via-api)
    - [Español](https://support.tive.com/es/referencing-saved-locations-via-api)

  English - United States
  
  Show submenu for translations
- Contact us

 Contact us

 How can we help you?

- There are no suggestions because the search field is empty.

1. [External Knowledge Base](https://support.tive.com/en-us?hsLang=en-us)
2. [Shipments](https://support.tive.com/en-us/shipments?hsLang=en-us)
3. [Shipment Data](https://support.tive.com/en-us/shipments?hsLang=en-us#shipment-data)

# Referencing Saved Locations via API

### **Why Use Saved Location Referencing?**

Many integrated Tive customers use the platform to create saved locations with precise geofences. However, referencing these saved locations via API has often been a challenge, leading to duplicate entries, incomplete shipments, and unnecessary alert noise.

Saved Location Referencing solves these issues by allowing users to reference pre-created locations using unique Tive-generated IDs, rather than manually entering coordinates and addresses each time.

### **Key Benefits:**

- **Eliminates location duplication** – No need to create the same location multiple times.
- **Reduces errors** – Prevents issues that lead to incomplete shipments and alert noise.
- **Streamlines shipment creation** – Use saved identifiers for faster, more reliable API interactions.
- **Improves consistency** – Maintains centralized, accurate location data across your organization.

**Note**: *This feature is available for customers on the* ***Premium*** *tier or any account with the API flag enabled.*

### **How It Works**

Follow the steps below to ensure your saved locations are referenced correctly via the API.

#### **Step 1: Verify That the Locations Are Saved**

- Navigate to **Configure \> Locations** in the Tive Platform.
- Click on the **Saved** tab and ensure your desired locations appear there.
- Use the search bar to locate a specific address or location name.

If a location isn’t under the **Saved** tab:

- Go to the **Suggested** tab.
- Find the location and click **Save Location**.
- Add any required information to officially save it.

#### **Step 2: Fetch Location IDs**

You can retrieve the unique Tive IDs (used for referencing via API) in two ways:

##### **Option 1: Via API (Recommended)**

- Call the [**List Locations**](https://developers.tive.com/reference/list-locations) endpoint: /public/v3/Locations.
- This will return a paginated list of your saved locations.
- Each location object will include an id field that can be used in shipment creation.

**Note***: View the Tive API Documentation [here](https://developers.tive.com/docs/getting-started).*

##### **Option 2: Via the Tive Platform**

- Go to **Configure \> Locations**.
- Each saved location includes a visible **ID** field that can be copied and used in the API.

#### **Step 3: Create a Shipment Using Location IDs**

- Use the [**Create Shipment**](https://developers.tive.com/reference/create-shipment) endpoint.
- Instead of entering an address and coordinates for each leg: 
    - Use the fromLocationId for the origin.
    - Use the toLocationId for the destination.

This references your saved locations directly, simplifying shipment creation and ensuring data accuracy.

### **Key Points to Know**

**Requirements:**

- Only available to Premium-tier customers or those with the API feature enabled.

**Avoid Common Mistakes:**

- Don’t skip saving a location before referencing it—this ensures you’re using high-quality geofences in all of your API-generated shipments.
- Always verify that you’re using the correct location id.

**Integration Tip:**

- Works seamlessly with other Tive API tools and shipment management workflows.
- Tive supports SSO via SAML 2.0, OpenID Connect, Microsoft Azure AD, or Active Directory. Contact your Account Manager or Account Executive for assistance setting up an integration.

### **Best Practices**

- **Always Use API for ID Fetching -** Automating the fetch process via API helps reduce human error and streamlines the workflow.
- **Audit Your Saved Locations Regularly -** Ensure your location data is clean, up to date, and correctly labeled to avoid confusion during API calls.
- **Centralize Location Creation -** Limit location creation to a designated admin or automated system to maintain data consistency and avoid duplicates.
- **Security Tip -** Avoid exposing sensitive location IDs in client-side code or unsecured environments.

- [Getting Started](https://support.tive.com/en-us/getting-started?hsLang=en-us#main-content)

    - [Platform](https://support.tive.com/en-us/getting-started?hsLang=en-us#platform)
    - [Trackers](https://support.tive.com/en-us/getting-started?hsLang=en-us#trackers)
    - [Tive Mobile App](https://support.tive.com/en-us/getting-started?hsLang=en-us#tive-mobile-app)
- [Tive Devices](https://support.tive.com/en-us/tive-devices?hsLang=en-us#main-content)

    - [Devices](https://support.tive.com/en-us/tive-devices?hsLang=en-us#devices)
    - [Tive Tag](https://support.tive.com/en-us/tive-devices?hsLang=en-us#tive-tag)
    - [Functionality](https://support.tive.com/en-us/tive-devices?hsLang=en-us#functionality)
- [Your Organization](https://support.tive.com/en-us/your-organization?hsLang=en-us#main-content)

    - [Software](https://support.tive.com/en-us/your-organization?hsLang=en-us#software)
    - [Hardware](https://support.tive.com/en-us/your-organization?hsLang=en-us#hardware)
- [Shipments](https://support.tive.com/en-us/shipments?hsLang=en-us#main-content)

    - [Shipment Alerts](https://support.tive.com/en-us/shipments?hsLang=en-us#shipment-alerts)
    - [Shipment Creation](https://support.tive.com/en-us/shipments?hsLang=en-us#shipment-creation)
    - [Shipment Data](https://support.tive.com/en-us/shipments?hsLang=en-us#shipment-data)
    - [Settings](https://support.tive.com/en-us/shipments?hsLang=en-us#settings)
    - [Shipment Collaboration](https://support.tive.com/en-us/shipments?hsLang=en-us#shipment-collaboration)
- [Tive Reveal](https://support.tive.com/en-us/tive-reveal?hsLang=en-us#main-content)

    - [Tive Reveal Overview](https://support.tive.com/en-us/tive-reveal?hsLang=en-us#tive-reveal-overview)
    - [Data Processing and Freshness](https://support.tive.com/en-us/tive-reveal?hsLang=en-us#data-processing-and-freshness)
    - [Carrier Insights](https://support.tive.com/en-us/tive-reveal?hsLang=en-us#carrier-insights)
    - [Lane Insights](https://support.tive.com/en-us/tive-reveal?hsLang=en-us#lane-insights)
- [Sharing Data](https://support.tive.com/en-us/sharing-data?hsLang=en-us#main-content)

    - [Shipments](https://support.tive.com/en-us/sharing-data?hsLang=en-us#shipments)
- [Analytics](https://support.tive.com/en-us/analytics?hsLang=en-us#main-content)

    - [Platform](https://support.tive.com/en-us/analytics?hsLang=en-us#platform)
    - [Dashboards](https://support.tive.com/en-us/analytics?hsLang=en-us#dashboards)
- [Workflow Automations](https://support.tive.com/en-us/workflow-automations?hsLang=en-us#main-content)

    - [Workflow Automations Overview](https://support.tive.com/en-us/workflow-automations?hsLang=en-us#workflow-automations-overview)
    - [Workflow Automation Templates](https://support.tive.com/en-us/workflow-automations?hsLang=en-us#workflow-automation-templates)

[![tive logo white](https://support.tive.com/hubfs/tive%20logo%20white.svg "tive logo white")](http://tive.com)

© 2026 Tive is a registered trademark of Tive, Inc.