Skip to main content
GET
/
v1
/
labor
/
rules
List labor rules
curl --request GET \
  --url https://api.plane.com/v1/labor/rules \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "data": [
    {
      "id": "lbrule_3WqNv8RkX2pYhJ",
      "object": "labor.rule",
      "type": "notice_period",
      "jurisdiction": { "country": "GB" },
      "status": "active",
      "code": "era1996_employer_minimum_notice",
      "name": "Employer minimum notice to terminate",
      "source": "legislation",
      "parameters": {
        "party": "employer",
        "duration": {
          "unit": "week",
          "scale": { "by": "service_years", "amount": "1", "floor": "1", "cap": "12" }
        }
      },
      "citations": [
        { "source": "lawsrc_A3EFrPDVRJ1D9D", "provision": "section-86" }
      ],
      "created": "2026-06-11T00:00:00Z",
      "updated": "2026-06-11T00:00:00Z"
    }
  ],
  "has_more": false
}

Parameters

type
string
Rule type: leave_entitlement, notice_period, pay_entitlement, probation_rule, threshold_rule, working_time_rule, dispute_remedy, minimum_wage, or worker_classification.
country
string
Two-letter country code.
state
string
State code, when state law applies.
locality
string
Locality, when local law applies.
code
string
Rule code. For minimum_wage rules this is the band (e.g. standard, youth).
source
string
provider (what Plane applies) or legislation (what the law establishes).
on
string
Effective date filter. Returns the rules in force on this date. Past dates return Plane’s currently corrected view of the law then (not a bitemporal claim about what the database knew at the time). Future dates are allowed and return the rules in force on that date.
status
string
Effective-date status: active, scheduled, expired, or superseded.
limit
number
A limit on the number of objects to be returned. Limit can range between 1 and 100.
cursor
string
Opaque pagination cursor.

Returns

A list object with object: "list", data, and has_more. When has_more is true the envelope also includes cursor, the opaque token to pass as cursor on the next request. Each element is a labor rule whose parameters carry the type-specific payload.
{
  "object": "list",
  "data": [
    {
      "id": "lbrule_3WqNv8RkX2pYhJ",
      "object": "labor.rule",
      "type": "notice_period",
      "jurisdiction": { "country": "GB" },
      "status": "active",
      "code": "era1996_employer_minimum_notice",
      "name": "Employer minimum notice to terminate",
      "source": "legislation",
      "parameters": {
        "party": "employer",
        "duration": {
          "unit": "week",
          "scale": { "by": "service_years", "amount": "1", "floor": "1", "cap": "12" }
        }
      },
      "citations": [
        { "source": "lawsrc_A3EFrPDVRJ1D9D", "provision": "section-86" }
      ],
      "created": "2026-06-11T00:00:00Z",
      "updated": "2026-06-11T00:00:00Z"
    }
  ],
  "has_more": false
}