---
title: "Get publication by custom domain"
method: GET
path: "/v1/publications/domain/{domain}"
tags: ["publications"]
---

# Get publication by custom domain

`GET /v1/publications/domain/{domain}`

## Request

- Base URL: `https://public.api.paragraph.com/api`
- URL: `https://public.api.paragraph.com/api/v1/publications/domain/{domain}`
- Auth: none required

Retrieve publication details using its custom domain

## Path parameters

- `domain` string, required

## Response `200`

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

## Other responses

- `404`: Publication not found
- `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-05-07** `90de04b87133`: 2 warning
  - removed the optional property `error` from the response with the `404` status
  - removed the optional property `error` from the response with the `500` status
- **2026-04-28** `79fe03bb4057`: 14 info
  - added the optional property `bodyFont` to the response with the `200` status
  - added the optional property `disableComments` to the response with the `200` status
  - added the optional property `disableHighlights` to the response with the `200` status
  - added the optional property `emailNotifications` to the response with the `200` status
  - …10 more

[Operation history](https://skmtc.dev/paragraph-xyz/apis/paragraph-api/changes/v1/publications/domain/:domain/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.dev/paragraph-xyz/apis/paragraph-api/revisions/c148c610fb95?raw)