How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Spade Category Personalization API

Create custom categories and personalize enrichments

Spade Category Personalization API is one of 8 APIs that Spade publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Category Personalization. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 16 operations across 8 paths, and defines 5 schemas. It is described by OpenAPI 3.2.0, at version 2.7.3.

Requests are made against 8 base URLs: https://east.sandbox.spade.com, https://east.api.spade.com, https://west.sandbox.spade.com, https://west.api.spade.com, https://sandbox.v2.spadeapi.com, https://v2.spadeapi.com, https://sandbox.west.v2.spadeapi.com, https://west.v2.spadeapi.com.

16 operations 8 paths 5 schemas 8 DELETE4 GET2 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2.7.3
Base URL
https://east.api.spade.com
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Spade Category Personalization API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-Api-Key (ApiKeyAuth). By default, every request must be authenticated.

Paths & Operations 16

Across 8 paths, the API surfaces 16 operations — 8 DELETE, 4 GET, 2 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Category Personalization 16

Create custom categories and personalize enrichments

POST
/categories
Create a custom integration-level category
categoriesPost body → 201400403500
DELETE
/categories
Delete all custom integration-level categories
categoriesDelete → 204403500
GET
/categories
Get all default and custom integration-level categories
categoriesGet 1 param → 200403500
POST
/users/{userId}/categories
Create a custom user-level category
userCategoriesPost 1 param body → 201400403500
DELETE
/users/{userId}/categories
Delete all custom user-level categories
userCategoriesDelete 1 param → 204403500
GET
/users/{userId}/categories
Get categories
userCategoriesGet 1 param → 200403500
PUT
/users/{userId}/counterparty-category-personalizations
Create a user-level counterparty category personalization
userCounterpartyCategoryPersonalizationsPut 1 param body → 200201400403500
DELETE
/users/{userId}/counterparty-category-personalizations
Delete all user-level counterparty category personalizations
userCounterpartyCategoryPersonalizationsDelete 1 param → 204403500
GET
/users/{userId}/counterparty-category-personalizations
Get all user-level counterparty category personalizations
userCounterpartyCategoryPersonalizationsGet 1 param → 200403500
PUT
/counterparty-category-personalizations
Create an integration-level counterparty category personalization
counterpartyCategoryPersonalizationsPut body → 200201400403500
DELETE
/counterparty-category-personalizations
Delete all integration-level counterparty category personalizations
counterpartyCategoryPersonalizationsDelete → 204403500
GET
/counterparty-category-personalizations
Get all integration-level counterparty category personalizations
counterpartyCategoryPersonalizationsGet → 200403500
DELETE
/counterparty-category-personalizations/{counterpartyId}
Delete a counterparty category personalization
counterpartyCategoryPersonalizationsDetailDelete 1 param → 204403500
DELETE
/categories/{id}
Delete a custom integration-level category
categoriesDetailDelete 1 param → 204403500
DELETE
/users/{userId}/categories/{id}
Delete a custom user-level category
userCategoriesDetailDelete 2 params → 204403500
DELETE
/users/{userId}/counterparty-category-personalizations/{counterpartyId}
Delete a user-level counterparty category personalization
userCounterpartyCategoryPersonalizationsDetailDelete 2 params → 204403500

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are MerchantCategory (4 properties), CustomCategory (4 properties), IndustryCategoryLevel (3 properties), CounterpartyCategoryPersonalization (2 properties). Each schema is shown below with its type and property counts.

CommonPostCategoriesRequest
object
Schema for creating a custom category.
2 properties 2 required
CustomCategory
object
4 properties
IndustryCategoryLevel
object
A node in a tree representing a hierarchical category system
3 properties
CounterpartyCategoryPersonalization
object
Schema for creating a counterparty category personalization.
2 properties 2 required
MerchantCategory
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

spade-category-personalization-api-openapi.yml Raw ↑

Other APIs Spade publishes across the network.

Spade Card Enrichment API
Spade Category Action Triggers API
Spade Feedback and Reporting API
Spade Merchant Action Triggers API
Spade Merchant Search API
Spade Transfer Enrichment API
Spade Universal Enrichment API
Where this information came from

This is an independent, third-party profile of Spade Category Personalization API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.