The Vertice API allows you to integrate procurement and vendor management workflows into your own systems. You can:

Initiate procurement requests
Manage vendors
Invoke workflow triggers

This article will walk you through how to create an API token and make your first successful request with cURL.

Before you begin

The features you need access to depend on how you intend to use the API. The following must be active on your account before you can proceed.

If you want to...	Required features
Initiate procurement requests and invoke workflow triggers	Requests, Intelligent Workflows, Vertice API
Manage vendors	Vertice API, Vendor Directory

If you're unsure whether you have these features or don't have access to a feature that you need, contact your Account Manager.

1. Open the Vertice API interface

The API interface is where you can manage your tokens, view active workflows using API triggers, and consult sample material for reference.

In Vertice, click Settings in the left-hand sidebar
Click Integrations
Switch to the API access tab

2. Generate a JWT token

Tokens authenticate your requests to the API.

Under Configured tokens, click Add Token.
Enter a name for the token — use something that identifies its purpose or owner (for example, vendor-sync-prod)
Select the scopes for this token — scopes define which endpoints the token can access
Click Generate Token
Click Copy Token and store it somewhere secure
Click Done

Caution

Once you finish these steps, you will not be able to view the token again. If you lose it, you will need to revoke it and generate a new one.

Token security information

Vertice API uses bearer tokens for authentication. Ensure you follow security best practices to mitigate risk on your end. If you have reason to suspect unauthorized use, revoke the token immediately to permanently de-activate it.

3. Make your first API call

To make your first request, you'll need your token to hand, and your account ID.

3.1. Find your account ID

You can find your account ID at the top-right corner of the Vertice API interface. Click it to copy it to your clipboard.

3.2 Try it out: List your active vendors

The following request retrieves the vendors associated with your account. It doesn't require a request body, making it a quick way to verify your setup.

curl -X GET 'https://api.vertice.one/public/accounts/{accountId}/vendors' \
  -H 'Authorization: Bearer {YOUR_JWT_TOKEN}'

A successful response returns 200 OK and a list of your active vendors:

{
  "vendors": [
    {
      "resourceUrn": "urn:verticeone:vertice:fb1c6240-9edd-48f0-872a-0fd9a6aef48b:vendor:vendor/6ec48b04-f814-4003-b75e-fe2d61b34201",
      "name": "My Vendor 1",
      "status": "ACTIVE",
      "createdAt": "2025-09-17T12:27:33.853635+00:00",
      "globalVendorUrn": "urn:verticeone:vertice:fb1c6240-9edd-48f0-872a-0fd9a6aef48b:vendor:vendor/6ec48b04-f814-4003-b75e-fe2d61b34201",
      "category": "Analytics Tools",
      "description": "My first vendor",
      "isPreferred": false,
      "preferenceLevel": 0
    },
    {
      "resourceUrn": "urn:verticeone:vertice:fb1c6240-9edd-48f0-872a-0fd9a6aef48b:vendor:vendor/6ec48b04-f814-4003-b75e-fe2d61b34201",
      "name": "My Vendor 2",
      "status": "ACTIVE",
      "createdAt": "2025-09-17T12:27:33.853635+00:00",
      "globalVendorUrn": "urn:verticeone:vertice:fb1c6240-9edd-48f0-872a-0fd9a6aef48b:vendor:vendor/6ec48b04-f814-4003-b75e-fe2d61b34201",
      "category": "Productivity Suite",
      "description": "My second vendor",
      "isPreferred": false,
      "preferenceLevel": 0
    }
  ],
  "metadata": {
    "totalCount": 2
  }
}

If you receive a 401, verify that your token is correctly formatted in the Authorization header and has not been revoked or expired.

Next steps

Consult our full API guide for more information about the Vertice API and its capabilities: Working with Public API Tokens.

Getting Started with the Vertice API