> ## 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.
# News
> Use client.news to list and retrieve Galactic News Service articles and sim news posts, with optional category filtering for sim news.
The `client.news` resource gives you programmatic access to two distinct news feeds in the Star Wars Combine universe. The Galactic News Service (GNS) carries in-character news written by players, while sim news carries out-of-character announcements and updates from the game administration. Both feeds expose a list method for pagination and a get method for fetching individual articles by numeric ID.
## Galactic News Service (GNS)
The GNS is the primary in-character news feed — player-authored articles covering galactic events, faction announcements, and political developments.
### news.gns.list()
Returns a paginated list of GNS articles, ordered by publication date.
1-based index of the first article to return.
Number of articles per page.
```typescript theme={null}
const articles = await client.news.gns.list();
console.log(articles.total); // Total GNS articles
for await (const article of articles) {
console.log(article.title, article.author, article.published_at);
}
```
### news.gns.get()
Retrieves the full content of a single GNS article by its numeric ID.
The numeric ID of the GNS article. Note this is a `number`, not a string UID.
```typescript theme={null}
const article = await client.news.gns.get({ id: 4521 });
console.log(article.title);
console.log(article.body);
console.log(article.author);
```
GNS article IDs are plain numbers, not the `"type:id"` string format used by entity UIDs elsewhere
in the SDK.
## Sim news
Sim news carries out-of-character content: game updates, rule changes, event announcements, and administration notices. Articles can be filtered by category.
### news.simNews.list()
Returns a paginated list of sim news posts.
Optional category filter. Omit to return posts across all categories.
1-based index of the first post to return.
Number of posts per page.
```typescript theme={null}
// All sim news
const allNews = await client.news.simNews.list();
// Filtered by category
const updates = await client.news.simNews.list({ category: 'game-update' });
for await (const post of updates) {
console.log(post.title, post.category, post.published_at);
}
```
### news.simNews.get()
Retrieves the full content of a single sim news post by its numeric ID.
The numeric ID of the sim news post.
```typescript theme={null}
const post = await client.news.simNews.get({ id: 892 });
console.log(post.title);
console.log(post.body);
```
## Full example
```typescript theme={null}
import { SWCombine } from 'swcombine-sdk';
const client = new SWCombine({ token: process.env.SWC_ACCESS_TOKEN! });
// Fetch the latest 10 GNS articles
const gns = await client.news.gns.list({ item_count: 10 });
for (const article of gns.data) {
console.log(`[GNS] ${article.title} by ${article.author}`);
}
// Fetch the latest 10 sim news posts
const simNews = await client.news.simNews.list({ item_count: 10 });
for (const post of simNews.data) {
console.log(`[Sim] ${post.title}`);
}
// Get a specific GNS article by ID
const full = await client.news.gns.get({ id: gns.data[0].id });
console.log(full.body);
```
## Related resources
Query in-game activity events for characters, factions, and combat.
Identify the author of a GNS article by character UID.
Look up faction details referenced in galactic news articles.
Learn how Page\ works and how to auto-paginate news feeds.