Developer Documentation
Comprehensive smart card reference for security engineers, payment system architects, and identity solution developers. Covers smart card types across payments, identity, transport, and telecom; standards (ISO 7816, EMV, GlobalPlatform); chip platforms (JavaCard, MULTOS); manufacturers; security certifications (Common Criteria, FIPS); form factors; personalization methods; interactive tools; glossary; and guides. 15 languages supported.
- Smart card types with full specs (chip, cryptography, communication, applet support, security)
- Card categories: contact, contactless, dual-interface, memory
- Standards: ISO 7816, ISO 14443, EMVCo, GlobalPlatform, GSMA, ICAO, FIDO, ETSI, NIST
- Chip platforms: JavaCard, MULTOS, native OS with architecture and API details
- Manufacturers: card and chip manufacturers with product lines and market data
- Card applications: payments, identity, transport, telecom, healthcare, access control
- Security certifications: Common Criteria EAL levels, FIPS, EMV certification
- Form factors: ID-1, mini-SIM, micro-SIM, nano-SIM, embedded, MicroSD
- Personalization methods: electrical, laser engraving, ink-jet, thermal transfer
- Interactive tools: APDU builder, ATR parser, card identifier, EAL comparator, eSIM checker, cost estimator
- Glossary and in-depth guides
- Side-by-side card type comparisons
Quick Start
curl -s "https://smartcardfyi.com/api/v1/card-types/"
API Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/card-types/ | List all smart card types |
| GET | /api/v1/card-types/{slug}/ | Card type detail with full specs |
| GET | /api/v1/categories/ | Card categories |
| GET | /api/v1/standards/ | Smart card standards |
| GET | /api/v1/manufacturers/ | Manufacturers |
| GET | /api/v1/applications/ | Application domains |
| GET | /api/v1/platforms/ | Chip platforms |
| GET | /api/v1/form-factors/ | Form factors |
| GET | /api/v1/certifications/ | Security certifications |
| GET | /api/v1/personalization/ | Personalization methods |
| GET | /api/v1/glossary/ | Glossary terms |
| GET | /api/v1/guides/ | Guide articles |
| GET | /api/v1/tools/ | Interactive tools |
| GET | /api/v1/faqs/ | FAQs |
| GET | /api/v1/stats/ | Site statistics |
| GET | /api/v1/search/?q={query} | Search across all content |
URL Patterns
Use these patterns to construct URLs programmatically:
/card/
Browse all smart card types (e.g. /card/)
/card/{slug}/
Card type detail with full specs (e.g. /card/emv-payment-card/)
/category/
Card categories (contact, contactless, dual) (e.g. /category/)
/category/{slug}/
Category detail (e.g. /category/dual-interface/)
/standard/
Smart card standards (e.g. /standard/)
/standard/{slug}/
Standard detail (e.g. /standard/iso-7816/)
/manufacturer/
Smart card manufacturers (e.g. /manufacturer/)
/manufacturer/{slug}/
Manufacturer detail (e.g. /manufacturer/thales/)
/application/
Card application domains (e.g. /application/)
/application/{slug}/
Application detail (e.g. /application/payment/)
/platform/
Chip platforms (e.g. /platform/)
/platform/{slug}/
Platform detail (e.g. /platform/javacard/)
/form-factor/
Card form factors (e.g. /form-factor/)
/form-factor/{slug}/
Form factor detail (e.g. /form-factor/id-1/)
/certification/
Security certifications (e.g. /certification/)
/certification/{slug}/
Certification detail (e.g. /certification/common-criteria/)
/personalization/
Personalization methods (e.g. /personalization/)
/personalization/{slug}/
Personalization method detail (e.g. /personalization/electrical/)
/glossary/
Smart card terminology glossary (e.g. /glossary/)
/glossary/{slug}/
Glossary term detail (e.g. /glossary/apdu/)
/guide/
In-depth smart card guides (e.g. /guide/)
/guide/{slug}/
Guide article (e.g. /guide/choosing-chip-platform/)
/tools/
Interactive smart card tools (e.g. /tools/)
/tools/apdu-builder/
APDU command builder (e.g. /tools/apdu-builder/)
/tools/atr-parser/
ATR string parser (e.g. /tools/atr-parser/)
/tools/card-identifier/
Smart card identifier (e.g. /tools/card-identifier/)
/tools/eal-comparator/
EAL level comparator (e.g. /tools/eal-comparator/)
/tools/esim-checker/
eSIM compatibility checker (e.g. /tools/esim-checker/)
/tools/cost-estimator/
Card cost estimator (e.g. /tools/cost-estimator/)
/compare/
Card type comparison index (e.g. /compare/)
/compare/{slug}/
Side-by-side comparison (e.g. /compare/emv-vs-sim/)
/search/
Search card types, terms, guides (e.g. /search/?q=emv)
Response Format
All endpoints return JSON with pagination:
Example JSON response
{
"count": 636,
"next": "https://example.com/api/v1/items/?page=2",
"previous": null,
"results": [
{"slug": "example", "name": "Example Item", "...": "..."}
]
}
OpenAPI Specification
Full API schema available as OpenAPI 3.1.0 JSON. Import into Swagger UI, Postman, or any OpenAPI-compatible tool.
SDK Packages
PyPI
pip install smartcardfyi
Smart card type data, standard reference, APDU commands
RubyGems
gem install smartcardfyi
Ruby smart card reference
crates.io
cargo add smartcardfyi
Rust smart card reference
Embed Widget
Embed data cards on your site:
https://widget.smartcardfyi.com
npm install smartcardfyi-embed
Format Support
- Markdown endpoints: Append
.mdto any page URL for LLM-friendly markdown output. - Internationalization: Content available in 14 languages: ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id.