Skip to main content

Documentation Index

Fetch the complete documentation index at: https://swc-sdk.zeltros.dev/llms.txt

Use this file to discover all available pages before exploring further.

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.