---
title: "API Documentation | CardSight AI"
description: "Complete docs: REST API, OpenAPI/Swagger spec, SDKs for Node.js, Python, Swift, Java & .NET, MCP for Claude, ChatGPT plugin. CardSight trading card identification. 99.5% accuracy, 16M+ trading cards. Start in minutes."
url: https://cardsight.ai/documentation
---

Documentation

# CardSight AI Documentation

[Get API Key](https://app.cardsight.ai/)[Swagger UI](https://api.cardsight.ai/documentation)[API Status](https://status.cardsight.ai)

Complete technical documentation for the AI-native trading card infrastructure from CardSight AI. Whether you're building a mobile app with Swift or .NET, a web service with Node.js, Python, or Java, or integrating AI assistants via Model Context Protocol, our comprehensive guides, API references, and SDKs provide everything you need to ship production-ready card features in minutes.

Start with our REST API for direct HTTP integration, use type-safe SDKs for language-native development, or leverage MCP to give AI assistants like Claude conversational access to our 16M+ trading card catalog. Each path includes detailed documentation, code examples, and best practices to accelerate your integration—from proof of concept to production scale. Get your free API key and access 750 calls per month to start building today.

Getting Started

## Core Documentation

Quick access to our API reference, SDKs, and AI integration guides. Everything you need to integrate CardSight AI into your application.

REST API

API Reference

Complete REST API documentation with examples and response schemas

[View](https://cardsight.ai/documentation/api-reference)

AI Integration

MCP Documentation

Model Context Protocol for AI assistants like Claude

[View](https://cardsight.ai/documentation/mcp)

SDKs & Libraries

Official SDKs for Node.js, Python, Swift, Java & .NET, plus OpenAPI/Swagger

[View](https://cardsight.ai/documentation/sdks)

Interactive Demo

## Try the API Playground

Experience CardSight AI in action with our interactive playground. Test every API endpoint visually and see real-time results—perfect for both developers and non-developers.

### Interactive Interface

Test card identification, pricing lookups, and all API features with a user-friendly interface

### Developer-Friendly

See actual API requests and responses in real-time. Copy code snippets for your projects.

### All Endpoints Supported

Test every API endpoint visually — card identification, search, pricing, collections, and more.

[Launch Playground](https://play.cardsight.ai)[Get API Key](https://app.cardsight.ai/)

### Get Started Today

Sign up for a free account to get your API key and start exploring CardSight AI in the playground.

[Sign Up Free](https://app.cardsight.ai/)

750 free API calls per month • No credit card required

Code Examples

## Quick Example

Get started with CardSight card identification using our official SDKs. Choose your preferred language and copy the code to start building.

Identify a Card

Send an image to get card details and pricing using our SDK

NPM Package

`npm install cardsightai`

[GitHub](https://github.com/CardSightAI/cardsightai-sdk-node)

```
import { CardSightAI, getFieldValue } from 'cardsightai';

// Initialize the client
const client = new CardSightAI({ apiKey: 'your_api_key_here' });

// Identify a card from an image
const imageFile = // File, Blob, Buffer, or ArrayBuffer
const result = await client.identify.card(imageFile);

// Access identification results
if (result.data?.success) {
  const detection = result.data.detections?.[0];
  if (detection?.card) {
    console.log(`Card: ${detection.card.name}`);
    console.log(`Confidence: ${detection.confidence}`);
    console.log(`Total cards detected: ${result.data.detections.length}`);

    // Pokemon, One Piece, and Magic detections report the printed
    // language as an ISO 639-1 code; undefined on sports cards
    console.log(getFieldValue(detection, 'CARD_LANGUAGE')); // "ja"
  }
}

// Response structure for multiple cards:
// {
//   success: true,
//   requestId: "req_xyz789",
//   detections: [
//     {
//       confidence: "High",
//       card: {
//         /* Card details */
//         fields: [{ key: "CARD_LANGUAGE", value: "ja" }]  // TCG only
//       }
//     }
//   ],
//   processingTime: 287
// }
```

Prefer another language? CardSight AI is OpenAPI 3.0 / Swagger compatible—generate a typed client for any stack, or browse the [full SDK guide](https://cardsight.ai/documentation/sdks).

## Ready to Start Building?

Get your API key and start identifying cards in minutes

[Get Your API Key](https://app.cardsight.ai/)