List icons

Browse the VEXiON cards 3D icon library. 10,000+ icons across 23 categories (Animals, Food & Drink, Technology & Media, etc.) for use as stamp_icon_url on stamp cards or pattern_icon_urls[] on non-stamp cards.

Scope: none required. The catalog is identical for every organization - curated centrally by VEXiON, containing no organization data - so any authenticated key may read it regardless of its scopes.

WHEN to use:

• Building a custom icon picker UI in your dashboard
• Letting end-customers pick icons for personalization
• Discovering icons for specific card designs

HOW it works:

• Cursor-paginated (default 25, max 100 per page - the same bounds as every other list endpoint)
• Ordered by slug ascending, NOT newest-first: this is a static catalog with no created_at
• Filter by category (23 fixed categories returned in response for client-side UI)
• Search by free text across icon title + tags (case-insensitive partial match)
• Returns image_url directly usable in Card.design.stamp_icon_url or pattern_icon_urls

GOTCHAS:

• The library is static (curated by VEXiON). Partners cannot add custom icons via this endpoint.
• Partners CAN still pass custom URLs to stamp_icon_url / pattern_icon_urls (uploaded to their own CDN). This endpoint just exposes our library.
• Heavy caching is fine - the catalog rarely changes (new icons added quarterly).

GET /v1/icons

List icons

cURL

curl --request GET \
  --url https://api.vexioncards.one/v1/icons \
  --header 'Authorization: Bearer <token>'

200

Food drink first page

{ "object": "list", "data": [ { "object": "icon", "slug": "coffee-cup", "title": "Coffee Cup", "category": "Food & Drink", "tags": [ "drink", "beverage", "cafe" ], "image_url": "https://stamp-icons.s3.eu-central-1.amazonaws.com/coffee-cup.png", "added_on": "2025-05-15" }, { "object": "icon", "slug": "croissant", "title": "Croissant", "category": "Food & Drink", "tags": [ "bakery", "pastry", "breakfast" ], "image_url": "https://stamp-icons.s3.eu-central-1.amazonaws.com/croissant.png", "added_on": "2025-05-15" }, { "object": "icon", "slug": "donut", "title": "Donut", "category": "Food & Drink", "tags": [ "dessert", "sweet", "breakfast" ], "image_url": "https://stamp-icons.s3.eu-central-1.amazonaws.com/donut.png", "added_on": "2025-05-15" } ], "has_more": true, "total_count": 487, "categories": [ "Animals", "Countries", "Education & Learning", "Entertainment & Leisure", "Events", "Everyday Life", "Fantasy & Imagination", "Fashion & Style", "Flags", "Food & Drink", "Health & Wellness", "Historical Figures", "History & Culture", "Hobbies", "Interface & Symbols", "Nature & Outdoors", "Places & Structures", "Professions", "Space & Science", "Sports", "Technology & Media", "Vehicles & Transport", "Work & Industry" ], "url": "/v1/icons" }

Authorizations

Authorization · string · header · required

Your secret API key as a Bearer token: Authorization: Bearer vxn_sk_.... Keys are created and scoped in the dashboard - see Authentication.

Query Parameters

category · enum<string>

Filter by category. Returns only icons in that category. Omit to include all categories.

Available options: Animals, Countries, Education & Learning, Entertainment & Leisure, Events, Everyday Life, Fantasy & Imagination, Fashion & Style, Flags, Food & Drink, Health & Wellness, Historical Figures, History & Culture, Hobbies, Interface & Symbols, Nature & Outdoors, Places & Structures, Professions, Space & Science, Sports, Technology & Media, Vehicles & Transport, Work & Industry

search · string

Free-text search across title + tags. Case-insensitive partial match.

Maximum string length: 100

limit · integer · default: 25

Items per page (1-100, Default 25).

Required range: 1 <= x <= 100

starting_after · string

Cursor: slug of the last icon on the previous page. Numeric offset or page parameters are not supported; cursors are the only supported paging mechanism.

Response

200

application/json

Paginated icon list.

Cursor-paginated list of icons from the VEXiON 3D icon library.

object · enum<string> · required

Always "list".

Available options: list

data · object[] · required

Icon objects for this page.

Show child attributes

has_more · boolean · required

True when more icons match after this page.

next_cursor · string | null

Cursor for the next page in the direction you are already paging, or null when this page ends the collection. has_more: true always comes with a non-null next_cursor.

Feed it back to the SAME parameter you used: starting_after when paging forward (the default), or ending_before when paging backward. Treat it as opaque and do not parse it.

You no longer need to take the last object's id yourself. That still works and is unchanged, but deriving the cursor from the page put the burden of knowing the sort direction on you, and it broke silently on any endpoint whose cursor is not the object id.

Example:

"cus_iofv5j4hn6bphinmmyat27tc5y"

total_count · integer

Total icons matching the query (across all pages). ~10,000 unfiltered.

Example:

10000

categories · enum<string>[]

The distinct category vocabulary - useful to build a filter dropdown.

Available options: Animals, Countries, Education & Learning, Entertainment & Leisure, Events, Everyday Life, Fantasy & Imagination, Fashion & Style, Flags, Food & Drink, Health & Wellness, Historical Figures, History & Culture, Hobbies, Interface & Symbols, Nature & Outdoors, Places & Structures, Professions, Space & Science, Sports, Technology & Media, Vehicles & Transport, Work & Industry

Example:

[
  "Animals",
  "Countries",
  "Education & Learning",
  "Entertainment & Leisure",
  "Events",
  "Everyday Life",
  "Fantasy & Imagination",
  "Fashion & Style",
  "Flags",
  "Food & Drink",
  "Health & Wellness",
  "Historical Figures",
  "History & Culture",
  "Hobbies",
  "Interface & Symbols",
  "Nature & Outdoors",
  "Places & Structures",
  "Professions",
  "Space & Science",
  "Sports",
  "Technology & Media",
  "Vehicles & Transport",
  "Work & Industry"
]

url · string

Stable collection URL.