Skip to main content
GET
/
users
/
{userId}
/
categories
Get categories
curl --request GET \
  --url https://east.sandbox.spade.com/users/{userId}/categories \
  --header 'X-Api-Key: <api-key>'
[
  {
    "id": "<string>",
    "name": "<string>",
    "icon": "<string>",
    "fullCategoryHierarchy": [
      {
        "id": "<string>",
        "name": "<string>",
        "icon": "<string>"
      }
    ]
  }
]

Authorizations

​
X-Api-Key
string
header
required

Path Parameters

​
userId
string
required

The userId of the relevant user.

Response

Successful operation

​
id
string

A unique identifier for this category.

Example:

"4d5419f1-bcde-40f5-9168-7f8989b9c55f"

​
name
string

The category's name

Example:

"Kitchen Remodel"

​
icon
string<url> | null

The category's icon, potentially inherited from the parent category.

Example:

"https://static.v2.spadeapi.com/categories/ee4ee39fd5474d31ac42f9e606b9040a/light.png"

​
fullCategoryHierarchy
object[]

Array with increasingly specific category information.

Example:
[
  {
    "id": "011-000-000-000",
    "name": "Retail",
    "icon": "https://static.v2.spadeapi.com/categories/ee4ee39fd5474d31ac42f9e606b9040a/light.png"
  },
  {
    "id": "4d5419f1-bcde-40f5-9168-7f8989b9c55f",
    "name": "Kitchen Remodel",
    "icon": "https://static.v2.spadeapi.com/categories/ee4ee39fd5474d31ac42f9e606b9040a/light.png"
  }
]