| Property | Details |
|---|---|
| URL: | https://www2.swcombine.com/ws/v2.0/faction/{uid}/stockholders[/] |
| Method: | GET |
| Description: | Gets a list of the stockholders of a faction |
| Pattern Description: |
uid (Mandatory): name or UID of faction |
| Rate Limited: | Yes |
| Query String: |
start_index (number): The first item to retrieve from the list, from 1 onwards (default 1). An invalid value is replaced by the default item_count (number): The number of items to retrieve (1 to 50, default 50). An invalid value is replaced by the default |
| Parameters: | N/A |
| Requires Authentication: | Yes |
| Permissions: |
faction_stocks: See the stocks your faction owns |
| Returns: |
200 OK: Returns a collection of all the stockholders |
| Examples: |
GET /ws/v2.0/faction/20:1001/stockholders/
JSON{
"version": "2.0",
"timestamp": 1767225600,
"resource": "faction_stockholders",
"request": "/ws/v2.0/faction/20:1001/stockholders/",
"swcapi": {
"stockholders": {
"attributes": {
"start": 1,
"total": 1
},
"characters": {
"character": [
{
"stockholder": {
"attributes": {
"uid": "1:1001",
"href": "https://www.swcombine.com/ws/v2.0/character/kira%20vane/"
},
"value": "Kira Vane"
},
"stocks": 0,
"percentage": 100
}
]
},
"factions": {}
}
}
}
XML<?xml version="1.0" encoding="UTF-8"?>
<swcapi xmlns="https://www.swcombine.com/ws/swcapi-ns/" version="2.0" timestamp="1767225600" resource="faction_stockholders" request="/ws/v2.0/faction/20:1001/stockholders/">
<stockholders start="1" total="1">
<characters count="1">
<character>
<stockholder uid="1:1001" href="https://www.swcombine.com/ws/v2.0/character/kira%20vane/">Kira Vane</stockholder>
<stocks>0</stocks>
<percentage>100</percentage>
</character>
</characters>
<factions/>
</stockholders>
</swcapi>
|