For AI agents

Pay calendars for 2026 to 2028 (biweekly, semi-monthly, monthly, weekly, federal, military, Social Security), 50 tech employers with the evidence behind each schedule, and the payday law of every state.

Calendars are computed from published rules; sources are checked every Monday

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/companieslimit?, offset?companies with rule, week known or not, source tier and the next payday (both possible dates when the week is unknown)
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

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

Shell

curl -s "https://paydays.fru.dev/api/companies?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/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 every Monday
Keep to 60 requests a minute or fewer
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.