NetrunnerDB API Documentation

Decklists are published decks from users.

Relationships

Decklist resources have the following relationships for their records.

Side
Faction
Cards

Filter - Get decklists containing all supplied Card ids

The card_id filter can accept a single card_id or a comma-separated list of card ids.

If multiple card ids are supplied, the decklist must contain all of the cards to be included in the results.

Endpoint

GET /api/v3/public/decklists?filter[card_id]=pennyshaver,stargate

Parameters

Name	Description	Type
card_id required	Card	string

Request

Route

GET /api/v3/public/decklists?filter[card_id]=pennyshaver,stargate

Headers

Content-Type: application/json
Host: api-preview.netrunnerdb.com

Query Parameters

filter={"card_id" => "pennyshaver,stargate"}

cURL

curl -g "https://api-preview.netrunnerdb.com/api/v3/public/decklists?filter[card_id]=pennyshaver,stargate" -X GET

Response

Simulated Response

Status

Headers

content-type: application/vnd.api+json; charset=utf-8

Body

{
  "data": [
    {
      "id": "22222222-2222-2222-2222-222222222222",
      "type": "decklists",
      "attributes": {
        "user_id": "locks",
        "follows_basic_deckbuilding_rules": false,
        "identity_card_id": "armand_geist_walker_tech_lord",
        "name": "Rad Runner Decklist",
        "notes": "",
        "tags": [
          "tag3",
          "tag4"
        ],
        "side_id": "runner",
        "created_at": "2023-12-08T12:00:00+00:00",
        "updated_at": "2023-12-08T12:00:00+00:00",
        "faction_id": "criminal",
        "card_slots": {
          "jailbreak": 3,
          "logic_bomb": 1,
          "networking": 3,
          "pennyshaver": 3,
          "pinhole_threading": 3,
          "stargate": 2,
          "sure_gamble": 3,
          "the_class_act": 2
        },
        "num_cards": 20,
        "influence_spent": 11
      },
      "relationships": {
        "side": {
          "links": {
            "related": "http://localhost:3000/api/v3/public/sides/runner"
          }
        },
        "faction": {
          "links": {
            "related": "http://localhost:3000/api/v3/public/factions/criminal"
          }
        },
        "cards": {
          "links": {
            "related": "http://localhost:3000/api/v3/public/cards?filter[decklist_id]=22222222-2222-2222-2222-222222222222"
          }
        }
      },
      "links": {
        "self": "http://localhost:3000/api/v3/public/decklists/22222222-2222-2222-2222-222222222222"
      }
    }
  ],
  "links": {
    "self": "http://localhost:3000/api/v3/public/decklists?filter%5Bcard_id%5D=pennyshaver%2Cstargate&page%5Bnumber%5D=1&page%5Bsize%5D=20&stats%5Btotal%5D=count",
    "first": "http://localhost:3000/api/v3/public/decklists?filter%5Bcard_id%5D=pennyshaver%2Cstargate&page%5Bnumber%5D=1&page%5Bsize%5D=20&stats%5Btotal%5D=count",
    "last": "http://localhost:3000/api/v3/public/decklists?filter%5Bcard_id%5D=pennyshaver%2Cstargate&page%5Bnumber%5D=&page%5Bsize%5D=20&stats%5Btotal%5D=count"
  },
  "meta": {
    "stats": {
      "total": {
        "count": {
          "22222222-2222-2222-2222-222222222222": 1
        }
      }
    }
  }
}