Get Started with Vee API

Everything you need to know to get started with the Vee API.

Get a Visier Account

To use the APIs, you must have a Visier account with a profile that has the API capability. If you don't have an account, contact your administrator. They will create an account for you with permissions that allow you to view data.

In addition to an API profile, any user who calls the Vee API needs a permission with the following capabilities:

• Vee

Generate your API key and security token

To make an API request, you will need an API key and a security token. For more information about how to get an API key and request a security token, see API Authentication.

Choose your tool

To begin working with the Vee API you will need to choose a tool to make your first request. This can be Postman or whichever method you usually use to make HTTP requests. For more information about using Postman for your first request, see Use Postman to Call Visier APIs.

Make your first request

To test that you have everything set up correctly, we'll create a request to retrieve a list of sample questions for Vee using the /v1alpha/vee/sample-questions endpoint. For a complete list of available endpoints, see "Vee" in API Reference.

The following sample request retrieves a list of sample questions to ask Vee. Replace {vanity_name} with your tenant name. The API key is expected as a header, while the security token is expected as a cookie.

1
2
3
curl -X GET --url 'https://{vanity_name}.api.visier.io/v1alpha/vee/sample-questions' \
-H 'apikey:{api_key}' \
-H 'Cookie:VisierASIDToken={security_token}'

If everything was set up correctly and the request was successful, you should see a similar response:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
{
  "questions": [{
    "question": "What is the turnover rate?",
    "metadata": {
      "categories": ["metricQuestion"]
    }
  }, {
    "question": "How many employees do we have in the US?",
    "metadata": {
      "categories": ["metricQuestion"]
    }
  }, {
    "question": "What is the relationship of span of control and turnover rate for managers?",
    "metadata": {
      "categories": ["craftVisual"]
    }
  }, {
    "question": "Is the turnover rate consistent with industry trends?",
    "metadata": {
      "categories": ["comparison"]
    }
  }, {
    "question": "What is the tenure for employees who left?",
    "metadata": {
      "categories": ["employeeEvent"]
    }
  }, {
    "question": "How has this changed over time?",
    "metadata": {
      "categories": ["adjustAnswer"]
    }
  }..]
}

Next steps

Now that you've successfully authenticated and completed your first API request, you're ready to start working with Vee using the Vee API.

To learn more:

• Explore the Vee API Code Samples.
• Review the API Reference.