---
title: "Get authenticated publication"
method: GET
path: "/v1/me"
tags: ["me"]
---

# Get authenticated publication

`GET /v1/me`

Returns the publication associated with the API key used in the request. Useful for verifying your API key and retrieving your publication details.

## Response `200`

Authenticated publication details retrieved successfully

- object
  - `id` string, required — Unique identifier for the publication
  - `name` string, required — Display name of the publication
  - `ownerUserId` string, required — ID of the user who owns this publication
  - `slug` string, required — URL-friendly identifier for the publication; accessible at paragraph.com/@[slug]
  - `customDomain` string, uri — Custom domain configured for this publication
  - `summary` string — Brief description of the publication (max 500 characters)
  - `logoUrl` string, uri — URL to the publication's logo image
  - `postListType` 'feed' | 'grid' | 'full-post' — Homepage layout. 'feed' is a single-column list of cards, 'grid' is a 3-column grid, 'full-post' shows full posts in a single column.
  - `themeColor` 'default' | 'orange-500' | 'rose-600' | 'pink-500' | 'fuchsia-600' | 'purple-600' | 'violet-600' | 'indigo-600' | 'blue-600' | 'sky-600' | 'cyan-600' | 'teal-600' | 'emerald-600' | 'green-600' | 'lime-600' | 'yellow-700' | 'amber-600' | 'orange-600' | 'stone-800' | 'rose-900' | 'indigo-950' | 'teal-950' | 'lime-950' | 'orange-950' — Theme accent color for the publication
  - `headerFont` 'default' | 'serif' | 'mono' — Font family used for headers
  - `bodyFont` 'default' | 'serif' | 'mono' — Font family used for body text
  - `showMostPopular` boolean — Whether the 'most popular posts' widget is shown
  - `hideStats` boolean — Whether to hide stats like subscriber count, post count, and collects
  - `featuredPost` string — Featured post selector. Use 'latest' for the most recent post, 'popular' for the most-viewed post, 'disabled' to hide the featured slot, or the ID of a specific post in this publication.
  - `enableTableOfContents` boolean — Whether the table of contents is enabled on posts
  - `enableSubscribePopup` boolean — Whether to show the subscribe popup to first-time visitors arriving from external links
  - `enableSubscribeScroll` boolean — Whether to show the subscribe popup when first-time visitors scroll a post
  - `pinnedPostIds` string[] — Ordered list of post IDs pinned to the top of the publication's homepage. Pinned posts render in their own section above the regular feed.
  - `emailNotifications` object — Owner-side email notification toggles
    - `newSubscriber` boolean — Email the writer when a new free subscriber signs up
  - `plan` 'free' | 'starter' | 'growth' | 'scale' — Subscription plan of the publication. Only returned on /v1/me.

## Other responses

- `401` — Invalid or missing API key
- `500` — Internal server error

## Changes

- **2026-08-19** `0b69669d5430` — 2 warning
  - removed the optional property `disableComments` from the response with the `200` status
  - removed the optional property `emailNotifications/newComment` from the response with the `200` status
- **2026-08-19** `f76f6f333ba8` — 3 warning
  - removed the optional property `disableHighlights` from the response with the `200` status
  - removed the optional property `emailNotifications/newContentCollected` from the response with the `200` status
  - removed the optional property `emailNotifications/newPaidSubscriber` from the response with the `200` status
- **2026-08-18** `36c72d74820a` — 1 info
  - response property `disableComments` list-of-types was narrowed by removing types `string` from media type `application/json` of response `200`
- **2026-08-04** `7bbf1b62c1a0` — 1 info
  - added the optional property `plan` to the response with the `200` status
- **2026-05-07** `90de04b87133` — 2 warning
  - removed the optional property `error` from the response with the `401` status
  - removed the optional property `error` from the response with the `500` status

[Full history](https://skmtc.dev/paragraph-xyz/apis/paragraph-api/changes/v1/me/get.md)

---

[API](https://skmtc.dev/paragraph-xyz/apis/paragraph-api.md) · [All operations](https://skmtc.dev/paragraph-xyz/apis/paragraph-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/paragraph-xyz/paragraph-api/revisions/8108f2a53d2e/schema)