---
title: "List Factions"
method: GET
path: "/api/factions"
tags: ["Factions"]
---

# List Factions

`GET /api/factions`

Returns paginated factions sorted by name by default. Factions hidden from the Delphi app are excluded.

## Query parameters

- `page` integer
- `page[number]` integer
- `page[size]` integer
- `filter[faction_type]` string
- `filter[has_reputation]` boolean
- `filter[lawful]` boolean
- `filter[is_npc]` boolean
- `filter[hide_in_delphi_app]` boolean
- `filter[query]` string
- `sort` string

## Response `200`

List of factions

- object
  - `data` FactionIndex[]
    - `uuid` string, uuid — Unique faction identifier.
    - `name` string — Display name of the faction.
    - `faction_type` string, nullable — Category of the faction. One of: Lawful, Unlawful, LawEnforcement, PrivateSecurity.
    - `lawful` boolean, nullable — Whether the faction is considered lawful.
    - `is_npc` boolean — Whether the faction is NPC-controlled.
    - `has_reputation` boolean — Whether the faction tracks player reputation.
    - `link` string, uri — API URL for the full faction detail.
  - `links` PaginationLinks — Pagination navigation links.
    - `first` string, nullable — URL to the first page.
    - `last` string, nullable — URL to the last page.
    - `prev` string, nullable — URL to the previous page.
    - `next` string, nullable — URL to the next page.
  - `meta` PaginationMeta — Pagination metadata.
    - `current_page` integer — Current page number.
    - `from` integer — Index of the first item in this page.
    - `last_page` integer — Last available page number.
    - `per_page` integer — Number of items per page.
    - `to` integer — Index of the last item in this page.
    - `total` integer — Total number of items across all pages.
    - `links` object[] — Pagination navigation links with page URLs.
      - `url` string, nullable
      - `label` string
      - `active` boolean
    - `path` string — Base URL path for pagination.

## Changes

- **2026-05-21** `af03a6ba771d` — 1 breaking, 5 info
  - the response's body type/format changed from `array`/`` to `object`/`` for status `200`
  - api operation id `9d3af437209fd7d1099972b9b9560aa6` removed and replaced with `listFactions`
  - api tag `In-Game` removed
  - added the optional property `data` to the response with the `200` status
  - …2 more
- **2026-04-19** `4efeaa4b4785` — 1 info
  - endpoint added
- **2026-03-29** `8ff40d443bb4` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/starcitizenwiki/apis/star-citizen-wiki-api/changes/api/factions/get.md)

---

[API](https://skmtc.dev/starcitizenwiki/apis/star-citizen-wiki-api.md) · [All operations](https://skmtc.dev/starcitizenwiki/apis/star-citizen-wiki-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/starcitizenwiki/star-citizen-wiki-api/revisions/8b259bb9a44c/schema)