# List Sharelists

`GET` `/v1/sharelists`

Get all community stock lists (sharelists) created by or subscribed to by the current user.

## Parameters

### Query Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `type` | string | No | Filter: `mine` or `subscribed`. Omit for both. |

## Request Example

```bash
curl --request GET \
  --url 'https://openapi.longbridge.com/v1/sharelists' \
  --header 'Authorization: Bearer <access_token>'
```

## Response

### Response Properties

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `sharelists` | object[] | No | User's own sharelists |
| `subscribed_sharelists` | object[] | No | Subscribed sharelists |
| `tail_mark` | string | No | Pagination cursor for subscribed list |
| `id` | integer | Yes | Sharelist ID |
| `description` | string | No | Description |
| `cover` | string | No | Cover image URL |
| `subscribers_count` | integer | No | Number of subscribers |
| `chg` | string | No | Day change percentage |
| `this_year_chg` | string | No | Year-to-date change percentage |
| `subscribed` | boolean | No | Whether the current user is subscribed |
| `sharelist_type` | integer | No | Type: `0`=regular, `3`=official, `4`=industry |
| `industry_code` | string | No | Industry code (for industry sharelists) |
| `symbol` | string | Yes | Security symbol |
| `code` | string | No | Ticker code |
| `market` | string | No | Market |
| `intro` | string | No | Brief description |
| `last_done` | string | No | Latest price |
| `change` | string | No | Day change percentage |
| `trade_status` | integer | No | Trade status code |
| `latency` | boolean | No | Whether quote data is delayed |
| `unread_change_log_category` | string | No | Unread change log category |

### Response JSON Example

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "mine": [
      {
        "id": 15921,
        "name": "AI Picks",
        "type": "Regular",
        "day_change": "-0.40",
        "ytd_change": "6.64",
        "subscribers": 500
      }
    ],
    "subscribed": []
  }
}
```
