Datacard

The client.datacard resource exposes the production license system in the Star Wars Combine universe. A datacard is a manufacturing license that authorizes a faction to produce a specific type of entity — a ship class, a weapon, a droid, and so on. By calling datacard.list() with a faction ID, you get the full list of entity types that faction is authorized to manufacture.

Listing datacards

datacard.list()

Returns a paginated list of all datacards held by a faction.

factionId

string

required

The faction UID in "type:id" format, e.g. "20:123". Note this parameter is named factionId, not uid.

const datacards = await client.datacard.list({ factionId: '20:123' });

console.log(datacards.total); // Total datacards held by this faction

for await (const card of datacards) {
  console.log(card.name, card.entityType, card.uid);
}

Getting a single datacard

datacard.get()

Retrieves a specific datacard by its UID.

uid

string

required

The datacard UID.

const card = await client.datacard.get({ uid: 'datacard-uid' });

console.log(card.name);
console.log(card.uid);

get() returns the datacard object directly — not a Page<T> wrapper. Access properties like card.name directly, not via card.data.

Full example

import { SWCombine } from 'swcombine-sdk';

const client = new SWCombine({ token: process.env.SWC_ACCESS_TOKEN! });

const factionId = '20:123';

// Get faction details
const faction = await client.faction.get({ uid: factionId });
console.log(`${faction.name} datacards:`);

// List all datacards
const datacards = await client.datacard.list({ factionId });
console.log(`${datacards.total} production licenses`);

for await (const card of datacards) {
  console.log(`  ${card.name} (${card.entityType})`);
}

Combine datacard.list() with types.entities.get() to enrich each datacard with the full technical specifications of the entity type it licenses.

The parameter name for datacard.list() is factionId, not uid. This differs from other resource methods that use uid for their primary identifier.

Faction

Retrieve faction details using the same faction UID.

Types

Look up full entity type definitions for the entities a datacard covers.

Inventory

List the ships and items a faction has already produced.

Pagination

Learn how Page<T> works and how to auto-paginate datacard lists.

Get Started

Authentication

Core Concepts

API Resources

Listing datacards

datacard.list()

Getting a single datacard

datacard.get()

Full example

Faction

Types

Inventory

Pagination

​Listing datacards

​datacard.list()

​Getting a single datacard

​datacard.get()

​Full example

​Related resources

Faction

Types

Inventory

Pagination

Listing datacards

datacard.list()

Getting a single datacard

datacard.get()

Full example

Related resources