Spade

Spade Feedback and Reporting API

Provide feedback on card events or report enrichment errors

GitHub OpenAPI

Operations 5

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/report Report an incorrect card enrichment · Report a card enrichment as incorrect #
Ask an LLM
“How do I tell Spade an enriched card transaction got the wrong merchant or category?”
“Can I flag that only the location on an enrichment was wrong?”
Tell an agent
Report enrichment {enrichmentId} as incorrect: {errorDescription}.
Flag the category on enrichment {enrichmentId} as wrong ({incorrectCategoryDescription}) with note {errorDescription}.
POST /enrichments/{enrichmentId}/chargeback Report a chargeback on an enriched transaction · Report that a chargeback occurred #
Ask an LLM
“How do I let Spade know a cardholder disputed a transaction with a chargeback?”
“Can I update a chargeback's state as the dispute moves along?”
Tell an agent
Record a chargeback in state {state} on enrichment {enrichmentId}.
Report a {state} chargeback on enrichment {enrichmentId} as fraud of type {fraudType}.
POST /enrichments/{enrichmentId}/decline Report a card decline on an enriched transaction · Report that a card decline occurred #
Ask an LLM
“How do I send Spade the decline code when a card authorization is refused?”
“Can I note that a declined card transaction was suspected fraud?”
Tell an agent
Report a card decline with code {declineCode} on enrichment {enrichmentId}.
Log that enrichment {enrichmentId} was declined at {occurredAt}: {declineDescription}.
POST /enrichments/{enrichmentId}/refund Report a refund on an enriched transaction · Report that a refund occurred #
Ask an LLM
“How do I tell Spade a merchant refunded a transaction it already enriched?”
“Can I attach notes and a timestamp when reporting a refund?”
Tell an agent
Report a refund on enrichment {enrichmentId}.
Record that enrichment {enrichmentId} was refunded at {occurredAt} with note {refundNotes}.
POST /enrichments/{enrichmentId}/fraud Report suspected fraud on a transaction · Report fraud on a transaction #
Ask an LLM
“Where do I report fraud that didn't involve a chargeback, decline or refund?”
“What fraud types can I attach to an enriched transaction?”
Tell an agent
Flag enrichment {enrichmentId} as suspected fraud of type {fraudType}.
Report standalone fraud on enrichment {enrichmentId} with notes {fraudNotes}.

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/spade/refs/heads/main/openapi/spade-feedback-and-reporting-api-openapi.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-feedback-and-reporting-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-feedback-and-reporting-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Spade Feedback and Reporting 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 (45 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/spade/refs/heads/main/openapi/spade-feedback-and-reporting-api-openapi.yml