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

# List social links

`GET /v1/account/social-links`

## Request

- Base URL: `https://api.grove.city` (the document declares no server; this is the origin it was published from)
- URL: `https://api.grove.city/v1/account/social-links`
- Auth: none declared

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.dev/grove/apis/grove-api.md) - [All operations](https://skmtc.dev/grove/apis/grove-api/llms.txt) - [OpenAPI document](https://skmtc.dev/grove/apis/grove-api/revisions/f286b48a8105?raw)