List publication field values <Badge intent="info" minimal outlined>OAuth Scope: publication_fields:read</Badge>

GET

https://api.beehiiv.com/v2/workspaces/publication_field_values

GET

/v2/workspaces/publication_field_values

curl -G https://api.beehiiv.com/v2/workspaces/publication_field_values \
     -H "Authorization: Bearer <token>" \
     -d publication_id=pub_00000000-0000-0000-0000-000000000000 \
     -d limit=10

{
  "data": [
    {
      "publication_field_id": "pub_field_00000000-0000-0000-0000-000000000000",
      "publication_field_name": "support_email",
      "publication_id": "pub_00000000-0000-0000-0000-000000000000",
      "publication_name": "Morning Brew",
      "status": "set",
      "value": "[email protected]",
      "fetched_at": null
    },
    {
      "publication_field_id": "pub_field_11111111-1111-1111-1111-111111111111",
      "publication_field_name": "weather",
      "publication_id": "pub_00000000-0000-0000-0000-000000000000",
      "publication_name": "Morning Brew",
      "status": "fetched_ok",
      "value": null,
      "fetched_at": 1700000000,
      "key_values": [
        {
          "key": "condition",
          "value": "Cloudy"
        },
        {
          "key": "temp",
          "value": "71"
        }
      ]
    }
  ],
  "limit": 10,
  "has_more": false,
  "next_cursor": null
}

Currently in beta

This feature is currently in beta and the API is subject to change.

Retrieve the values a publication field resolves to. Provide exactly one of publication_id, for each field of a single publication, or publication_field_id, for a single field across every publication in the workspace.

Values are reported as they stand. Fetched fields are not retrieved as part of this request; use fetched_at to judge how current a value is.

Requires an API key with access to every publication in the workspace.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

publication_idstringOptionalformat: "^(pub_[0-9a-fA-F\-]+)$"

Return one result per field for this publication. Cannot be combined with publication_field_id.

publication_field_idstringOptionalformat: "^(pub_field_[0-9a-fA-F\-]+)$"

Return one result per publication for this field. Cannot be combined with publication_id. Archived fields are accepted, since their values still resolve in content.

statusenumOptional

Filter the fields returned for a publication by whether they have been archived. Only applies alongside publication_id, and defaults to active.

Allowed values:

limitintegerOptional

A limit on the number of objects to be returned. The limit can range between 1 and 100, and the default is 10.

cursorstringOptional

Cursor-based pagination (recommended): Use this opaque cursor token to fetch the next page of results. When provided, pagination will use cursor-based method which is more efficient and consistent than offset-based pagination.

pageintegerOptional

Offset-based pagination (deprecated): Page number for offset-based pagination. Please migrate to cursor-based pagination using the cursor parameter. If not specified, results 1-10 from page 1 will be returned.

Response

datalist of objects

An array of publication field values.

limitintegerOptional

The limit placed on the results. If no limit was specified in the request, this defaults to 10.

has_morebooleanOptional

Cursor pagination only: Indicates whether there are more results available after the current page. Only present when using cursor-based pagination.

next_cursorstringOptional

Cursor pagination only: The cursor token to use for fetching the next page of results. This will be null if has_more is false. Only present when using cursor-based pagination.

pageintegerOptional

Offset pagination only: The page of results returned. Only present when using the deprecated page parameter.

total_resultsintegerOptional

The total number of results from all pages.

total_pagesintegerOptional

Offset pagination only: The total number of pages. Only present when using the deprecated page parameter.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error