Free

Get Card Lists

List all card lists with pagination and filtering

What This Does

Returns all card lists with pagination
Shows list names, descriptions, and owners
Supports filtering by collector or name
Provides total count for pagination

When To Use This

Viewing all available lists
Finding lists by name
Getting lists for a specific collector
Building a list picker/dropdown

Real Example

Scenario

You retrieve all your card lists

Sample Request

GET

/v1/lists/?take=20

What You Get Back

{
  "lists": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "collectorId": "550e8400-e29b-41d4-a716-446655440099",
      "name": "My Wishlist",
      "description": "Cards I want to collect"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "collectorId": "550e8400-e29b-41d4-a716-446655440099",
      "name": "Set Completion Goals",
      "description": null
    }
  ],
  "total_count": 2,
  "skip": 0,
  "take": 20
}