Spade

Spade Card Enrichment API

Enrich card transactions

GitHub OpenAPI

Operations 10

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /transactions/cards/enrich Enrich a single card transaction · Enrich a card transaction #
Ask an LLM
“How do I turn a raw card swipe into a clean merchant name, logo and category with Spade?”
“Which optional fields like acquirer ID or card BIN improve the match on one card transaction?”
Tell an agent
Enrich the card transaction from user {userId} for {amount} {currencyCode} at merchant {merchantName}, MCC {categoryCode}, on {occurredAt}.
Enrich card purchase {transactionId} made at {location} and tag it with program {programId}.
POST /transactions/cards/enrich/parse Enrich a card transaction from a raw DE43 field · Enrich a card transaction with an unparsed de43 #
Ask an LLM
“Can I send the unparsed DE43 field instead of splitting out merchant name and city myself?”
“What happens when the DE43 string conflicts with the merchant name I also pass in?”
Tell an agent
Parse DE43 message {de43} and enrich that card transaction for user {userId}, {amount} {currencyCode} on {occurredAt}.
Enrich the card swipe with raw DE43 {de43} and MCC {categoryCode} at {location}.
OPTIONS /batches/transactions/cards/enrich Check the synchronous cap for card batch enrichment · Get metadata for the batch card enrichment endpoint #
Ask an LLM
“What is the current synchronousMax for enriching card transaction batches inline?”
“How many card transactions can I send in one synchronous microbatch right now?”
Tell an agent
Fetch the current synchronous item cap for the card batch enrichment endpoint.
Look up the metadata for card transaction batch enrichment.
POST /batches/transactions/cards/enrich Submit a batch of card transactions for enrichment · Enrich a batch of card transactions #
Ask an LLM
“How do I enrich thousands of card transactions in one job instead of one at a time?”
“Can a card enrichment batch call my URL when the job finishes?”
Tell an agent
Submit these card transactions {transactions} as an enrichment batch and notify {callbackUrl} when done.
Enrich this microbatch of card transactions {transactions} synchronously ({synchronous}).
OPTIONS /batches/transactions/cards/enrich/parse Check the synchronous cap for DE43 batch enrichment · Get metadata for the batch card parse enrichment endpoint #
Ask an LLM
“What is the inline item limit for batch DE43 parse enrichment of card transactions?”
“Where can I fetch the synchronousMax for the card parse batch endpoint?”
Tell an agent
Get the current synchronous cap for the DE43 card parse batch endpoint.
Read the metadata for batch card enrichment with DE43 parsing.
POST /batches/transactions/cards/enrich/parse Submit a batch of DE43 card transactions · Enrich a batch of card transactions with DE43 data #
Ask an LLM
“Can I batch-enrich card transactions that only carry raw DE43 strings?”
“Do batched DE43 card transactions still need merchant name and city fields?”
Tell an agent
Submit the DE43 card transactions {transactions} as a parse-and-enrich batch, calling {callbackUrl} on completion.
Parse and enrich this small set of DE43 card swipes {transactions} inline with synchronous={synchronous}.
GET /batches/{cardEnrichmentBatchId}/results Get results of a card enrichment batch · Get the results of a batch card enrichment job #
Ask an LLM
“How do I download the enriched transactions once my card batch job is finished?”
“Where do the results of a batch card enrichment job come back?”
Tell an agent
Fetch the enriched results of card batch {cardEnrichmentBatchId}.
Pull the output of card enrichment job {cardEnrichmentBatchId}.
GET /batches/{cardEnrichmentBatchId} Check the status of a card enrichment batch · Get the status of a batch card enrichment job #
Ask an LLM
“Is my batch card enrichment job still running or has it completed?”
“How can I poll progress on a card transaction batch I submitted?”
Tell an agent
Check whether card batch {cardEnrichmentBatchId} has finished.
Show the job status for card enrichment batch {cardEnrichmentBatchId}.
POST /transactions/enrich Enrich a card transaction via the legacy endpoint · Enrich a card transaction #
Ask an LLM
“Does the old /transactions/enrich card endpoint still work?”
“My integration calls the legacy transaction enrich path; what does it map to now?”
Tell an agent
Enrich a card transaction through the deprecated /transactions/enrich alias.
Send this card transaction to the legacy enrich endpoint my old integration uses.
POST /transactions/enrich/parse Enrich a DE43 card transaction via the legacy endpoint · Enrich a card transaction with an unparsed de43 #
Ask an LLM
“Is the legacy /transactions/enrich/parse DE43 endpoint still supported?”
“What replaced the old DE43 parse path for card enrichment?”
Tell an agent
Enrich a DE43 card transaction through the deprecated /transactions/enrich/parse alias.
Send this raw DE43 swipe to the legacy parse endpoint my old code still calls.

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/spade/refs/heads/main/openapi/spade-card-enrichment-api-openapi.yml

Other Resources

🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/spade/refs/heads/main/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/spade:spade-card-enrichment-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

spade-card-enrichment-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Spade Card Enrichment API
  description: Documentation for Spade's card transaction enrichment API and related endpoints. We offer sandbox and production environments on both the east coast and west coast to enable ultra low latency enrichment for realtime applications. Each environment requires different API keys. To inquire about API keys, please contact your Spade representative or reach out to .
  version: 2.7.3
servers:
- url: https://east.sandbox.spade.com
  description: East coast sandbox environment
- url: https://east.api.spade.com
  description: East coast production environment
- url: https://west.sandbox.spade.com
  description: West coast sandbox environment
- url: https://west.api.spade.com
  description: West coast production environment
- url: https://sandbox.v2.spadeapi.com
  description: East coast sandbox environment (deprecated)
- url: https://v2.spadeapi.com
  description: East coast production environment (deprecated)
- url: https://sandbox.west.v2.spadeapi.com
  description: West coast sandbox environment (deprecated)
- url: https://west.v2.spadeapi.com
  description: West coast production environment (deprecated)
security:
- ApiKeyAuth: []
tags:


# --- truncated at 32 KB (56 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/spade/refs/heads/main/openapi/spade-card-enrichment-api-openapi.yml