---
title: "List social links"
method: GET
path: "/v1/account/social-links"
tags: ["profiles"]
---

# List social links

`GET /v1/account/social-links`

List all social links for the authenticated user.

Returns an array of social link objects, each containing:
- **id**: Unique identifier for the link
- **platform**: Platform name (x, github, discord, etc.)
- **url**: Full URL to the social profile
- **verified**: Whether ownership has been verified
- **created_at**: ISO 8601 timestamp

Returns an empty list if no social links are configured.

Authentication: `Authorization: Bearer <CLIENT_JWT>`

## Headers

- `authorization` string, nullable — Bearer JWT issued by Grove that identifies the account.

## Response `200`

Successful Response

- SocialLinkResponse[]
  - `id` string, required — Identity ID for the social link
  - `platform` string, required — Platform name
  - `url` string, required — Full URL to the social profile
  - `verified` boolean — Whether ownership has been verified
  - `verified_at` string, nullable — When ownership was verified (ISO 8601)
  - `verification_method` string, nullable — How ownership was verified (e.g., oauth_youtube)
  - `created_at` string, required — When the link was added (ISO 8601)
  - `display_name` string, nullable — Display name from the platform profile

## Other responses

- `401` — Missing or invalid JWT
- `422` — Validation Error

---

[API](https://skmtc.net/grove/apis/grove-api.md) · [All operations](https://skmtc.net/grove/apis/grove-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/grove/grove-api/revisions/f286b48a8105/schema)