---
title: REST API Getting Started
description: 1. Creating the API key 2. Creating a data table using a CSV file 3. Updating a data table using a CSV file 4. Finding a data set a unique identifier Procedure       Uploading a data set is as simple
---

[Skip to content](https://knowledge.cartovista.com/rest-api-getting-started#main-content)

English

Show submenu for translations

![cartovista-logo (1).png\]](https://knowledge.cartovista.com/hs-fs/hubfs/cartovista-logo%20(1).png?height=40&name=cartovista-logo%20(1).png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- Go to cartovista.com

 Go to cartovista.com

 You have reached the CartoVista v7 knowledge base. How can we help you?

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

1. [Help Center](https://knowledge.cartovista.com/?hsLang=en)
2. [Features](https://knowledge.cartovista.com/features?hsLang=en)
3. [CartoVista Server REST API](https://knowledge.cartovista.com/features?hsLang=en#cartovista-server-rest-api)

# REST API Getting Started

[1. Creating the API key](https://knowledge.cartovista.com/rest-api-getting-started#creating)

[2. Creating a data table using a CSV file](https://knowledge.cartovista.com/rest-api-getting-started#creating)

[3. Updating a data table using a CSV file](https://knowledge.cartovista.com/rest-api-getting-started#update)

[4. Finding a data set a unique identifier](https://knowledge.cartovista.com/rest-api-getting-started#finding)

### 1. Creating the API key

#### **Prerequisites**

1. A server license that has the REST API module.
2. An admin account that has access to the user management module for the creation of the key.

**Procedure**

1. From the **Users** module in the left-hand side menu
2. Select the user for whom you want to create a key, alternatively, you can create an “API User” dedicated for your application.
3. Add a new key, providing the IP address of the server accessing the API. API key user is requiring to whitelist the callers servers.

![api-3](https://knowledge.cartovista.com/hs-fs/hubfs/Knowledge%20Base%20Import/api-3-1.png?width=688&name=api-3-1.png)

 Once generated you will have a 32 character long key made of one combination of letters and numbers, this is all you need to get started.

### 2. Creating a data table using a CSV file

     Uploading a data set is as simple as connecting to the API and streaming it to the server.

**Prerequisites**

     A .CSV file

**C# Sample Code** 

![api-1](https://knowledge.cartovista.com/hs-fs/hubfs/Knowledge%20Base%20Import/api-1-1.png?width=688&name=api-1-1.png)

### 3. Updating a data table using a CSV file

Similar to the creation example, updating a data set is the same process with a different method.

**Prerequisites**

A .CSV file

ℹ️   Make sure the CSV file used for the update has the same column name as the original CSV file.

**C# Sample Code**

In the example above, simply replace line 24 with this one.

![api-2](https://knowledge.cartovista.com/hs-fs/hubfs/Knowledge%20Base%20Import/api-2-1.png?width=688&name=api-2-1.png)

### 4. Finding a data set a unique identifier

To do so, simply…

1. Go to your data section
2. Select the data set
3. The unique id is on the right of the “Identifier” attribute.

![api-portal](https://knowledge.cartovista.com/hs-fs/hubfs/Knowledge%20Base%20Import/api-portal-1.jpg?width=688&name=api-portal-1.jpg)

 

 

- [Features](https://knowledge.cartovista.com/features?hsLang=en#main-content)

    - [Introduction to CartoVista](https://knowledge.cartovista.com/features?hsLang=en#introduction-to-cartovista)
    - [Territory Manager](https://knowledge.cartovista.com/features?hsLang=en#territory-manager)
    - [Microsoft Active Directory Support](https://knowledge.cartovista.com/features?hsLang=en#microsoft-active-directory-support)
    - [CartoVista Viewer](https://knowledge.cartovista.com/features?hsLang=en#cartovista-viewer)
    - [CartoVista Publisher](https://knowledge.cartovista.com/features?hsLang=en#cartovista-publisher)
    - [CartoVista Server](https://knowledge.cartovista.com/features?hsLang=en#cartovista-server)
    - [Online Editing](https://knowledge.cartovista.com/features?hsLang=en#online-editing)
    - [Grid Layers](https://knowledge.cartovista.com/features?hsLang=en#grid-layers)
    - [CartoVista Server REST API](https://knowledge.cartovista.com/features?hsLang=en#cartovista-server-rest-api)
    - [Scoring Analysis](https://knowledge.cartovista.com/features?hsLang=en#scoring-analysis)
- [How To](https://knowledge.cartovista.com/how-to?hsLang=en#main-content)

    - [Maps](https://knowledge.cartovista.com/how-to?hsLang=en#maps)
    - [Tiles](https://knowledge.cartovista.com/how-to?hsLang=en#tiles)
    - [Data](https://knowledge.cartovista.com/how-to?hsLang=en#data)
    - [Users and permissions](https://knowledge.cartovista.com/how-to?hsLang=en#users-and-permissions)
    - [License Keys](https://knowledge.cartovista.com/how-to?hsLang=en#license-keys)
- [Release Notes](https://knowledge.cartovista.com/release-notes?hsLang=en#main-content)

    - [Version 6](https://knowledge.cartovista.com/release-notes?hsLang=en#version-6)
    - [Version 7](https://knowledge.cartovista.com/release-notes?hsLang=en#version-7)
- [Cloud Permit](https://knowledge.cartovista.com/cloud-permit?hsLang=en)
- [FAQ](https://knowledge.cartovista.com/faq?hsLang=en)
- [Quick Start](https://knowledge.cartovista.com/quick-start?hsLang=en#main-content)

    - [Add your data](https://knowledge.cartovista.com/quick-start?hsLang=en#add-your-data)
    - [Get your dataset ready](https://knowledge.cartovista.com/quick-start?hsLang=en#get-your-dataset-ready)
    - [Build your map](https://knowledge.cartovista.com/quick-start?hsLang=en#build-your-map)
    - [Get Ready](https://knowledge.cartovista.com/quick-start?hsLang=en#get-ready)
    - [Publish your map](https://knowledge.cartovista.com/quick-start?hsLang=en#publish-your-map)

[![CartoVista](https://knowledge.cartovista.com/hs-fs/hubfs/cartovista.png?width=200&height=40&name=cartovista.png "CartoVista")](https://cartovista.com/)

This is CartoVista v7 Help Center.  
For the latest documentation on CartoVista Cloud v8, visit [cartovista.com/docs](https://cartovista.com/docs/)  
For assistance, visit [cartovista.com/technical-support](https://cartovista.com/technical-support/)

Copyright © 2026, CartoVista