Get authenticated publication
Returns the publication associated with the API key used in the request. Useful for verifying your API key and retrieving your publication details.
apiKeyAuthorizationBearer <token>API key for authenticating protected endpoints. Pass as Bearer token in Authorization header.
Authenticated publication details retrieved successfully
application/json- response
id*stringUnique identifier for the publication
name*stringDisplay name of the publication
ownerUserId*stringID of the user who owns this publication
slug*stringURL-friendly identifier for the publication; accessible at paragraph.com/@[slug]
1 <= length <= 256customDomain?stringCustom domain configured for this publication
urisummary?stringBrief description of the publication (max 500 characters)
length <= 500logoUrl?stringURL to the publication's logo image
uripostListType?stringHomepage layout. 'feed' is a single-column list of cards, 'grid' is a 3-column grid, 'full-post' shows full posts in a single column.
"feed""grid""full-post"themeColor?stringTheme accent color for the publication
"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"headerFont?stringFont family used for headers
"default""serif""mono"bodyFont?stringFont family used for body text
"default""serif""mono"showMostPopular?booleanWhether the 'most popular posts' widget is shown
hideStats?booleanWhether to hide stats like subscriber count, post count, and collects
featuredPost?stringFeatured 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.
1 <= lengthenableTableOfContents?booleanWhether the table of contents is enabled on posts
enableSubscribePopup?booleanWhether to show the subscribe popup to first-time visitors arriving from external links
enableSubscribeScroll?booleanWhether to show the subscribe popup when first-time visitors scroll a post
pinnedPostIds?array<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?Owner-side email notification toggles
plan?stringSubscription plan of the publication. Only returned on /v1/me.
"free""starter""growth""scale"curl -X GET "https://example.com/v1/me"{ "id": "string", "name": "string", "ownerUserId": "string", "slug": "string", "customDomain": "http://example.com", "summary": "string", "logoUrl": "http://example.com", "postListType": "feed", "themeColor": "default", "headerFont": "default", "bodyFont": "default", "showMostPopular": true, "hideStats": true, "featuredPost": "string", "enableTableOfContents": true, "enableSubscribePopup": true, "enableSubscribeScroll": true, "pinnedPostIds": [ "string" ], "emailNotifications": { "newSubscriber": true }, "plan": "free"}