For AI agents

Pay calendars for 2026 to 2028 (biweekly, semi-monthly, monthly, weekly, federal, military, Social Security), a growing set of employers (every company in the registry at companies.fru.dev, researched a few at a time) with the evidence behind each schedule, and the payday law of every state.

Calendars are computed from published rules; sources are checked on the 1st of every month; new registry companies are enrolled daily and company schedules are researched every month.

Point your agent here

Summary for language modelshttps://paydays.fru.dev/llms.txt
Full data as plain texthttps://paydays.fru.dev/llms-full.txt
OpenAPI 3.1 spec (load as tools)https://paydays.fru.dev/openapi.json

Call the API

MethodPathParamsReturns

GETGET /api/companies/{slug}slug, year?the company, its schedule (rule, whether the week is known, source tier, basis), sources with quotes, and paydays per possible week
GETGET /api/companiessince?, status?, limit?, offset?companies with status (tracked or candidate), provenance (discoveredVia, sourceUrl, firstSeen, lastChecked, verified), rule, week known or not, source tier and the next payday (both possible dates when the week is unknown); candidates have schedule null
GETGET /api/changessince?, limit?append-only change rows (slug, name, field, old, new, sourceUrl, sourceType, at), newest first
GETGET /api/growthnonetotal, sourced, researched, candidates, added30 and weekly[] (week, metric, value)
GETGET /api/schedules/{id}id, year?the schedule rule and its paydays (date, nominal date, reason moved)
GETGET /api/payday-lawslimit?, offset?states with the pay frequencies marked, the note and the source
GETGET /api/publishednonecalendars with organisation, year, dates and source URL
GETGET /api/searchq, limit?up to 20 ranked results with title, link and one line

GET/api/companies/{slug}

One company's pay schedule, the evidence behind it, and its paydays for a year

slugCompany slug, e.g. meta, google, amd
yearYear, 2026 to 2028 (default: the current year)

Shell

curl -s "https://paydays.fru.dev/api/companies/meta?year=2027"

Sample response

JSON

{
  "slug": "meta",
  "name": "Meta",
  "domain": "meta.com",
  "url": "https://paydays.fru.dev/companies/meta",
  "schedule": {
    "frequency": "biweekly",
    "rule": "Every other Friday",
    "weekday": "Friday",
    "days": null,
    "weekKnown": true,
    "anchor": "2024-01-19",
    "tier": "employee-reported",
    "assumed": [],
    "basis": "Employee-reported: every other Friday, from 5 employee reports. A reported payday on Jan 19, 2024 fixes the week."
  },
  "sources": [
    {
      "url": "https://www.teamblind.com/post/did-meta-pay-today-qy40ggoh",
      "note": "\"There is a wiki with all paydates. It's every two weeks... So on 01/19 you get paid for 1/1-1/14.\" (Blind, 2024-01-12)"
    },
    {
      "url": "https://www.teamblind.com/post/meta-pay-schedule-and-procedure-hv4ftfzn",
      "note": "\"Yes, 9/16 is the payout for 8/28-9/9.\" (Blind, 2022-08-31)"
    }
  ],
  "checkedAt": "2026-09-24",
  "year": 2027,
  "nextPaydays": [
    "2026-09-25"
  ],
  "series": [
    {
      "week": null,
      "label": "Every other Friday",
      "paydays": [
        {
          "nominal": "2027-01-15",
          "date": "2027-01-15",
          "reason": ""
        },
        {
          "nominal": "2027-01-29",
          "date": "2027-01-29",
          "reason": ""
        }
      ]
    }
  ],
  "company": {
    "slug": "meta",
    "name": "Meta",
    "domain": "meta.com",
    "frequency": "biweekly",
    "weekday": "Friday",
    "semimonthlyDays": null,
    "examplePayday": "2024-01-19",
    "sourceType": "employee-reported",
    "confidence": "medium",
    "sources": [
      {
        "url": "https://www.teamblind.com/post/did-meta-pay-today-qy40ggoh",
        "note": "\"There is a wiki with all paydates. It's every two weeks... So on 01/19 you get paid for 1/1-1/14.\" (Blind, 2024-01-12)"
      },
      {
        "url": "https://www.teamblind.com/post/meta-pay-schedule-and-procedure-hv4ftfzn",
        "note": "\"Yes, 9/16 is the payout for 8/28-9/9.\" (Blind, 2022-08-31)"
      }
    ],
    "notes": "Several employee reports agree: every other Friday. Two dated paydays (Sep 16, 2022 and Jan 19, 2024) and the 27th paycheck in 2026 all p...",
    "checkedAt": "2026-09-24"
  }
}

GET/api/companies

Every tracked employer with its schedule and next payday, researched first, then candidates not researched yet

sinceOnly companies first seen or researched on or after this date (YYYY-MM-DD)
statustracked or candidate (default: both)
limitItems per page, 1 to 200
offsetItems to skip, for the next page

Shell

curl -s "https://paydays.fru.dev/api/companies?status=tracked&limit=3"

Sample response

JSON

{
  "items": [
    {
      "slug": "amd",
      "name": "AMD",
      "domain": "amd.com",
      "url": "https://paydays.fru.dev/companies/amd",
      "schedule": {
        "frequency": "biweekly",
        "rule": "Every other Thursday",
        "weekday": "Thursday",
        "days": null,
        "weekKnown": false,
        "anchor": null,
        "tier": "official",
        "assumed": [
          "week"
        ],
        "basis": "Official: every other Thursday, from 3 sources, including the company's own. Which Thursday is not stated, so both are shown."
      },
      "sources": [
        {
          "url": "https://ir.amd.com/financial-information/sec-filings/content/0000002488-24-000123/exh10_1guidoxofferxlettera.htm",
          "note": "\"AMD pays on a bi-weekly basis on Thursday, with the exception of the first paycheck for exempt employees who begin work in a pay week, w..."
        },
        {
          "url": "https://ir.amd.com/financial-information/sec-filings/content/0000002488-23-000003/exh10_1jhuofferletter.htm",
          "note": "\"AMD pays on a bi-weekly basis on Thursday, with the exception of the first paycheck for exempt employees who begin work in a pay week, w..."
        }
      ],
      "checkedAt": "2026-09-23",
      "nextPaydays": [
        "2026-09-24",
        "2026-10-01"
      ]
    },
    {
      "slug": "accenture",
      "name": "Accenture",
      "domain": "accenture.com",
      "url": "https://paydays.fru.dev/companies/accenture",
      "schedule": {
        "frequency": "biweekly",
        "rule": "Every other Friday",
        "weekday": "Friday",
        "days": null,
        "weekKnown": false,
        "anchor": null,
        "tier": "no-evidence",
        "assumed": [
          "frequency",
          "weekday"
        ],
        "basis": "No published schedule or employee report yet. Shown as every other Friday, the usual schedule at large US tech employers; which Friday is..."
      },
      "sources": [],
      "checkedAt": "2026-09-23",
      "nextPaydays": [
        "2026-09-25",
        "2026-10-02"
      ]
    }
  ],
  "total": 50,
  "limit": 3,
  "offset": 0,
  "next": "/api/companies?limit=3&offset=3",
  "asOf": "2026-09-24"
}

GET/api/changes

What changed and when: companies added, schedules set or changed, with the source of each change

sinceChanges on or after this date (YYYY-MM-DD)
limitRows, 1 to 500 (default 100)

Shell

curl -s "https://paydays.fru.dev/api/changes?since=2026-09-01&limit=5"

GET/api/growth

Live counts: companies so far, with a sourced schedule, candidates, added in the last 30 days, and weekly snapshots

Shell

curl -s "https://paydays.fru.dev/api/growth"

GET/api/schedules/{id}

Every payday of a standard schedule in a year, with the ones moved off weekends and bank holidays

idSchedule id
yearYear, 2026 to 2028 (default 2027)

Shell

curl -s "https://paydays.fru.dev/api/schedules/biweekly-a?year=2027"

Sample response

JSON

{
  "id": "biweekly-a",
  "name": "Biweekly, cycle A",
  "rule": "Every other Friday, starting Friday, January 2, 2026",
  "year": 2027,
  "shift": "before",
  "paydays": [
    {
      "nominal": "2027-01-15",
      "date": "2027-01-15",
      "reason": ""
    },
    {
      "nominal": "2027-01-29",
      "date": "2027-01-29",
      "reason": ""
    }
  ],
  "url": "https://paydays.fru.dev"
}

GET/api/payday-laws

How often each state requires wages to be paid, per the U.S. Department of Labor table

limitItems per page, 1 to 200
offsetItems to skip, for the next page

Shell

curl -s "https://paydays.fru.dev/api/payday-laws?limit=3"

Sample response

JSON

{
  "items": [
    {
      "slug": "alabama",
      "state": "Alabama",
      "abbr": "AL",
      "dolText": "No frequency marked in DOL table; state name carries footnote 1",
      "frequencies": [],
      "notes": "No payday frequency requirement listed by DOL. Alabama and Florida. No regulations or not specified.",
      "statute": "",
      "sourceUrl": "https://www.dol.gov/agencies/whd/state/payday",
      "stateSourceUrl": "",
      "stateSourceSummary": "",
      "checkedAt": "2026-09-22",
      "url": "https://paydays.fru.dev/payday-laws/alabama"
    },
    {
      "slug": "alaska",
      "state": "Alaska",
      "abbr": "AK",
      "dolText": "Semi-monthly, Monthly",
      "frequencies": [
        "semimonthly",
        "monthly"
      ],
      "notes": "",
      "statute": "",
      "sourceUrl": "https://www.dol.gov/agencies/whd/state/payday",
      "stateSourceUrl": "",
      "stateSourceSummary": "",
      "checkedAt": "2026-09-22",
      "url": "https://paydays.fru.dev/payday-laws/alaska"
    }
  ],
  "total": 51,
  "limit": 3,
  "offset": 0,
  "next": "/api/payday-laws?limit=3&offset=3",
  "dolRevised": "2023-01-01"
}

GET/api/published

Pay calendars published by SSA, DFAS, NFC and GSA, as stored with their sources

Shell

curl -s "https://paydays.fru.dev/api/published"

Sample response

JSON

{
  "published": [
    {
      "id": "dfas-military-2026",
      "org": "DFAS",
      "name": "Active duty paydays 2026",
      "kind": "military",
      "year": 2026,
      "dates": [
        "2026-01-15",
        "2026-01-30"
      ],
      "sourceUrl": "https://www.dfas.mil/MilitaryMembers/payentitlements/2026ACPayDay/",
      "notes": "The end-of-month pay is paid on the 1st of the next month. DFAS has not published 2027 yet.",
      "origin": "seed",
      "status": "published",
      "reviewed": true,
      "matches": null
    },
    {
      "id": "dfas-military-annuitant-2026",
      "org": "DFAS",
      "name": "Military annuitant pay dates 2026 (from October 2026 entitlement)",
      "kind": "military-annuitant",
      "year": 2026,
      "dates": [
        "2026-11-02",
        "2026-12-01"
      ],
      "sourceUrl": "https://www.dfas.mil/RetiredMilitary/manage/payschedule/",
      "notes": "DFAS publishes a rolling schedule; this covers entitlement months October 2026 to December 2027.",
      "origin": "seed",
      "status": "published",
      "reviewed": true,
      "matches": null
    }
  ]
}

GET/api/search

Search companies, schedules and state law pages

qCompany, schedule or state
limitResults, 1 to 20

Shell

curl -s "https://paydays.fru.dev/api/search?q=meta&limit=3"

Sample response

JSON

{
  "q": "meta",
  "results": [
    {
      "id": "co:meta",
      "group": "companies",
      "title": "Meta",
      "subtitle": "Employee-reported · Every other Friday",
      "href": "/companies/meta",
      "keywords": [
        "meta.com",
        "meta"
      ],
      "logo": "https://img.logo.dev/meta.com?token=...&format=png&theme=light&size=64&retina=true&fallback=404",
      "score": 1050
    },
    {
      "id": "page:/method",
      "group": "pages",
      "title": "Method",
      "subtitle": "How company paydays are sourced",
      "href": "/method",
      "icon": "info",
      "score": 150
    }
  ]
}

Add to your agent

System prompt

For US paydays, pay schedules, federal and military pay dates, Social Security payment dates and state payday laws, fetch https://paydays.fru.dev/llms.txt and use https://paydays.fru.dev/api/companies/{slug} (spec: https://paydays.fru.dev/openapi.json). Cite "Paydays (paydays.fru.dev)" with a link.

Usage terms

Free to read, no key needed
Cite "Paydays (paydays.fru.dev)" with a link
Responses are cached; calendars are computed from published rules; sources are checked on the 1st of every month; new registry companies are enrolled daily and company schedules are researched every month
Keep to 60 requests a minute or fewer
Companies with status "candidate" are enrolled from the registry and not researched yet: they have no schedule. Company schedules marked "No evidence yet" are assumptions (biweekly Fridays, both possible weeks), not facts about the company. Employee-reported schedules are not confirmed by the company.