Policy Feed

Retrieves policy updates filtered by handbook ID and optional date ranges. Returns policy updates with full HTML content ready to be inserted into handbooks, including details about state-specific changes, new regulations, and compliance requirements.

Important: The handbook must have an active subscription (SUBSCRIPTION status) for this endpoint to work. This endpoint does not work with ONE_TIME subscriptions or unsubscribed handbooks.

Note: The query requires a handbookId to determine which states to filter updates for. The handbook must belong to the authenticated user.

Query

query PolicyFeed($filters: PolicyFeedFilters!) {
  policyFeed(filters: $filters) {
    total
    policyUpdates {
      date
      month
      year
      scope
      title
      content
      summary
      instructions
      conditions
    }
  }
}

Parameters

Parameter	Type	Required	Description
filters	PolicyFeedFilters!	Yes	Filters for filtering updates by handbook ID and optional date range

PolicyFeedFilters Input

Field	Type	Required	Description
handbookId	Int!	Yes	Handbook ID to filter updates for. Returns updates relevant to this handbook's states. The handbook must belong to the authenticated user.
startDate	String	No	Start date for filtering policy updates in YYYY-MM format. When provided, returns updates from this month onwards regardless of handbook creation date. If not provided, defaults to the handbook creation date.
endDate	String	No	End date for filtering policy updates in YYYY-MM format. Returns updates up to this month.

Response

{
  "data": {
    "policyFeed": {
      "total": 2,
      "policyUpdates": [
        {
          "date": "2025-08-01",
          "month": 8,
          "year": 2025,
          "scope": "CA",
          "title": "California - Paid Sick Leave",
          "content": "<p><strong>California - Paid Sick Leave</strong></p>...",
          "summary": "California expands paid sick leave to include new qualifying reasons for leave usage.",
          "instructions": "Replace the existing California Paid Sick Leave policy...",
          "conditions": "This policy includes new reasons for leave usage."
        },
        {
          "date": "2025-08-01",
          "month": 8,
          "year": 2025,
          "scope": "NY",
          "title": "New York - Paid Family Leave",
          "content": "<p><strong>New York - Paid Family Leave</strong></p>...",
          "summary": "New York expands paid family leave coverage to include additional family members.",
          "instructions": "Replace the existing New York Paid Family Leave policy...",
          "conditions": "This update expands coverage to additional family members."
        }
      ]
    }
  }
}

Examples

Get All Updates for a Handbook

query {
  policyFeed(filters: { handbookId: 123 }) {
    total
    policyUpdates {
      date
      month
      year
      scope
      title
      content
      summary
      instructions
      conditions
    }
  }
}

This returns policy updates relevant to the states covered by handbook ID 123, including federal (US) updates that apply to all states.

Filter Policy Updates by Date Range

query {
  policyFeed(filters: {
    handbookId: 123
    startDate: "2025-07"
    endDate: "2025-08"
  }) {
    total
    policyUpdates {
      date
      month
      year
      scope
      title
      content
      summary
      instructions
      conditions
    }
  }
}

This returns policy updates for July-August 2025, filtered by the states covered by handbook ID 123.

Variables

{
  "filters": {
    "handbookId": 123,
    "startDate": "2025-07",
    "endDate": "2025-08"
  }
}

Response Fields

PolicyFeedResponse

Field	Type	Description
total	Int!	Total number of policy updates found
policyUpdates	[PolicyUpdateItem!]!	Array of policy updates with full HTML content

PolicyUpdateItem

Field	Type	Description
date	String!	The date of the update in YYYY-MM-DD format
month	Int!	Month of the update (1-12)
year	Int!	Year of the update
scope	String!	State code (e.g., CA, NY, TX) or US for federal updates that apply to all states
title	String!	Title of the policy update
content	String!	Full HTML content of the policy update ready to be inserted into a handbook
summary	String	Brief summary of the policy update from the related compliance update
instructions	String	Instructions for how to apply this update to your handbook
conditions	String	Context about when/why this update applies

Use Cases

• Staying Current: Monitor state-specific employment law changes
• Handbook Updates: Identify which handbooks need updates based on new compliance requirements
• Multi-State Operations: Track policy changes across all states where your company operates
• Compliance Integration: Integrate real-time updates into handbook management systems
• Programmatic Updates: Use the content field to automatically update handbook content with ready-to-use HTML

Notes

• Requires bearer token authentication
• The handbook must have an active subscription (SUBSCRIPTION status) - This endpoint does not work with ONE_TIME subscriptions or unsubscribed handbooks
• Date format for startDate and endDate must be YYYY-MM (e.g., "2025-08")
• Date filtering behavior:
  • If startDate is provided, it overrides the handbook creation date and returns updates from the specified date
  • If startDate is not provided, only updates from the handbook creation date onwards are returned
  • This allows you to retrieve historical updates by explicitly specifying a startDate
• The scope field contains the state code (e.g., CA, NY, TX) or US for federal updates
• Returns updates relevant to the states configured in the specified handbook, plus federal (US) updates that apply to all states
• Policy updates are ordered by year and month (most recent first)
• The content field contains full HTML that can be directly inserted into handbooks
• The handbook must belong to the authenticated user