Categories
Ths module can be used to retrieve categories to select specific templates when creating token collections
Categories are essential to create your own Token. A token can be anything you want: a piece of art, a ticket for a show a certificate for your antiquity... Categories are here to separate token templates so it is easier to find them all, all templates created fall under a category. Our API already has a set of generic categories for you but if you want a new category can be created for an specific company.
List Generic Categories
List all generic Categories
Gets all existing NFT category
W3block API key
Need user with one of these roles: superAdmin, admin
GET /categories HTTP/1.1
Host:
x-w3block-api-key: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"companyId": "text",
"subcategories": [
{}
],
"name": "text",
"image": "text",
"createdAt": "2025-12-07T02:12:30.667Z",
"updatedAt": "2025-12-07T02:12:30.667Z"
}
]Create a Category for your Company
If you want a category that is not listed on the generics you can create your own category for your Company
Create a new NFT category for a company
W3block API key
Need user with one of these roles: superAdmin, admin
POST /{companyId}/categories HTTP/1.1
Host:
x-w3block-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 30
{
"name": "text",
"image": "text"
}{
"id": "text",
"companyId": "text",
"subcategories": [
{}
],
"name": "text",
"image": "text",
"createdAt": "2025-12-07T02:12:30.667Z",
"updatedAt": "2025-12-07T02:12:30.667Z"
}List Categories by Company
List all Company Categories, this includes all categories you created plus all generic categories with a template that you created.
Gets an existing NFT category that matches the id
W3block API key
Need user with one of these roles: superAdmin, admin
GET /{companyId}/categories/{id} HTTP/1.1
Host:
x-w3block-api-key: YOUR_API_KEY
Accept: */*
{
"id": "text",
"companyId": "text",
"subcategories": [
{}
],
"name": "text",
"image": "text",
"createdAt": "2025-12-07T02:12:30.667Z",
"updatedAt": "2025-12-07T02:12:30.667Z"
}Update a Company Category
Updates an existing NFT category for a company
W3block API key
Need user with one of these roles: superAdmin, admin
PUT /{companyId}/categories/{id} HTTP/1.1
Host:
x-w3block-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 30
{
"name": "text",
"image": "text"
}{
"id": "text",
"companyId": "text",
"subcategories": [
{}
],
"name": "text",
"image": "text",
"createdAt": "2025-12-07T02:12:30.667Z",
"updatedAt": "2025-12-07T02:12:30.667Z"
}Get Category info
Gets an existing NFT category that matches the id
W3block API key
Need user with one of these roles: superAdmin, admin
GET /categories/{id} HTTP/1.1
Host:
x-w3block-api-key: YOUR_API_KEY
Accept: */*
{
"id": "text",
"companyId": "text",
"subcategories": [
{}
],
"name": "text",
"image": "text",
"createdAt": "2025-12-07T02:12:30.667Z",
"updatedAt": "2025-12-07T02:12:30.667Z"
}Last updated