Delivr.ai Taxonomy API

Preparing to use the API

Step 1. Registration

Request example:

curl --request POST \
     --url https://apiv2.delivr.ai/auth/v1/register \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "email": "[email protected]",
  "password": "test_password",
  "first_name": "John",
  "last_name": "Smith",
  "organization_name": "Test Inc"
}
'

Response example:

{
  "message": "Successfully registered."
}

Step 2. Login

Use the public auth endpoint to obtain your JWT:

https://docs.delivr.ai/reference/postv1authlogin-1#

Request example:

{
curl --request POST \
     --url https://apiv2.delivr.ai/auth/v1/login \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "email": "[email protected]",
  "password": "test_password"
}
'
}

Response example:

{
  "user_id": "221708ad-7dad-49e0-80bd-5884267****",
  "organization_id": "66fede73-6811-4a73-beea-461b2f****",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...****"
}

Step 3. Create API Client

Request example:

{
curl --request POST \
     --url https://apiv2.delivr.ai/client/v1 \
     --header 'accept: application/json' \
     --header 'authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...****' \
     --header 'content-type: application/json' \
     --data '
{
  "name": "test"
}
'
}

Response example:

{
  "client_id":"69ee5598-b550-46e4-a7cf-c1a9124c***",
  "api_key":"dlvr_f0997864bf3db3bc99d68864e72***",
  "api_secret":"b0b1b44a54c8fe77bda7634e9e86da00883a20c92ceabb521ad01e4d654***",
  "created_at":"2025-11-06 14:49:50"
}

Using this api_key, you’ll be able to start working with our Taxonomy API

👍
You can now start using our endpoints

API Overview

Examples and description of possible requests:

Intent topics categories

list categories — /categories
get category by ID — /categories/9c44a3f7-b1e2-4d1f-8e21-5b2f0c7d9a77
count categories by filters — /categories/count

Intent topics subcategories

list subcategories — /subcategories
get subcategory by ID — /subcategories/7b63468b-c4f2-4c3c-02d5-c82f977cf308
count subcategories — /subcategories/count

Intent Topics

list intent topics — /topics
get topic by ID — /topics/f41ea874-735f-4884-a0a1-6521f45afa7d
topics count — /topics/count

Topic requests

🚧
Processing requests to add new topics is not automated. It may take some time

list/create topic requests — /topic-requests
read/update a specific request — /topic-requests/2df5a8c8-cfcc-4729-be1a-33ae39159619— read/update a specific request
requests count — /topic-requests/count
get reviews/notes for a specific intent topic — /topic-reviews/f41ea874-735f-4884-a0a1-6521f45afa7d