List payrolls

curl --request GET \
  --url https://sandbox.nmbr.co/services/payroll/payrolls \
  --header 'Authorization: Bearer <token>'

{
  "object": "list",
  "data": [
    {
      "id": "<id>",
      "object": "payroll",
      "data": {
        "business_entity": {
          "id": "<id>",
          "object": "business_entity",
          "links": {
            "self": "/business_entities/<id>"
          }
        },
        "pay_schedule": {
          "id": "<id>",
          "object": "pay_schedule",
          "links": {
            "self": "/pay_schedules/<id>"
          }
        },
        "type": "regular",
        "period_number": 6,
        "period_label": "6",
        "period_start": "2026-06-01",
        "period_end": "2026-06-30",
        "pay_date": "2026-06-30",
        "original_pay_date": "2026-06-30",
        "debit_date": "2026-06-25",
        "approval_due_at": "2026-06-25T20:30:00.000000Z",
        "regular_periods_count": 12,
        "is_impacted_by_weekend_or_holiday": false,
        "is_blocked_by_draft": true,
        "note": null,
        "employee_summary": {
          "gross": null,
          "subtractions": null,
          "reimbursements": null,
          "net": null
        },
        "contractor_summary": {
          "gross": null,
          "reimbursements": null,
          "net": null
        },
        "company_summary": {
          "taxes_and_contributions": null,
          "benefits": null,
          "total": null
        },
        "liability": null,
        "cash_requirement": null,
        "status": "draft",
        "approved_at": null,
        "is_stale": false,
        "stale_since": null,
        "source_payroll": null,
        "warnings": {
          "object": "list",
          "data": []
        },
        "external_ref": null,
        "created_at": "2026-01-01T00:00:00.000000Z",
        "updated_at": "2026-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/payrolls/<id>"
      }
    },
    {
      "id": "<id>",
      "object": "payroll",
      "data": {
        "business_entity": {
          "id": "<id>",
          "object": "business_entity",
          "links": {
            "self": "/business_entities/<id>"
          }
        },
        "pay_schedule": {
          "id": "<id>",
          "object": "pay_schedule",
          "links": {
            "self": "/pay_schedules/<id>"
          }
        },
        "type": "regular",
        "period_number": 7,
        "period_label": "7",
        "period_start": "2026-07-01",
        "period_end": "2026-07-31",
        "pay_date": "2026-07-31",
        "original_pay_date": "2026-07-31",
        "debit_date": "2026-07-28",
        "approval_due_at": "2026-07-28T20:30:00.000000Z",
        "regular_periods_count": 12,
        "is_impacted_by_weekend_or_holiday": false,
        "is_blocked_by_draft": true,
        "note": null,
        "employee_summary": {
          "gross": null,
          "subtractions": null,
          "reimbursements": null,
          "net": null
        },
        "contractor_summary": {
          "gross": null,
          "reimbursements": null,
          "net": null
        },
        "company_summary": {
          "taxes_and_contributions": null,
          "benefits": null,
          "total": null
        },
        "liability": null,
        "cash_requirement": null,
        "status": "draft",
        "approved_at": null,
        "is_stale": false,
        "stale_since": null,
        "source_payroll": null,
        "warnings": {
          "object": "list",
          "data": []
        },
        "external_ref": null,
        "created_at": "2026-01-01T00:00:00.000000Z",
        "updated_at": "2026-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/payrolls/<id>"
      }
    },
    {
      "id": "<id>",
      "object": "payroll",
      "data": {
        "business_entity": {
          "id": "<id>",
          "object": "business_entity",
          "links": {
            "self": "/business_entities/<id>"
          }
        },
        "pay_schedule": {
          "id": "<id>",
          "object": "pay_schedule",
          "links": {
            "self": "/pay_schedules/<id>"
          }
        },
        "type": "regular",
        "period_number": 8,
        "period_label": "8",
        "period_start": "2026-08-01",
        "period_end": "2026-08-31",
        "pay_date": "2026-08-31",
        "original_pay_date": "2026-08-31",
        "debit_date": "2026-08-26",
        "approval_due_at": "2026-08-26T20:30:00.000000Z",
        "regular_periods_count": 12,
        "is_impacted_by_weekend_or_holiday": false,
        "is_blocked_by_draft": true,
        "note": null,
        "employee_summary": {
          "gross": null,
          "subtractions": null,
          "reimbursements": null,
          "net": null
        },
        "contractor_summary": {
          "gross": null,
          "reimbursements": null,
          "net": null
        },
        "company_summary": {
          "taxes_and_contributions": null,
          "benefits": null,
          "total": null
        },
        "liability": null,
        "cash_requirement": null,
        "status": "draft",
        "approved_at": null,
        "is_stale": false,
        "stale_since": null,
        "source_payroll": null,
        "warnings": {
          "object": "list",
          "data": []
        },
        "external_ref": null,
        "created_at": "2026-01-01T00:00:00.000000Z",
        "updated_at": "2026-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/payrolls/<id>"
      }
    },
    {
      "id": "<id>",
      "object": "payroll",
      "data": {
        "business_entity": {
          "id": "<id>",
          "object": "business_entity",
          "links": {
            "self": "/business_entities/<id>"
          }
        },
        "pay_schedule": {
          "id": "<id>",
          "object": "pay_schedule",
          "links": {
            "self": "/pay_schedules/<id>"
          }
        },
        "type": "regular",
        "period_number": 9,
        "period_label": "9",
        "period_start": "2026-09-01",
        "period_end": "2026-09-30",
        "pay_date": "2026-09-29",
        "original_pay_date": "2026-09-30",
        "debit_date": "2026-09-24",
        "approval_due_at": "2026-09-24T20:30:00.000000Z",
        "regular_periods_count": 12,
        "is_impacted_by_weekend_or_holiday": true,
        "is_blocked_by_draft": true,
        "note": null,
        "employee_summary": {
          "gross": null,
          "subtractions": null,
          "reimbursements": null,
          "net": null
        },
        "contractor_summary": {
          "gross": null,
          "reimbursements": null,
          "net": null
        },
        "company_summary": {
          "taxes_and_contributions": null,
          "benefits": null,
          "total": null
        },
        "liability": null,
        "cash_requirement": null,
        "status": "draft",
        "approved_at": null,
        "is_stale": false,
        "stale_since": null,
        "source_payroll": null,
        "warnings": {
          "object": "list",
          "data": []
        },
        "external_ref": null,
        "created_at": "2026-01-01T00:00:00.000000Z",
        "updated_at": "2026-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/payrolls/<id>"
      }
    },
    {
      "id": "<id>",
      "object": "payroll",
      "data": {
        "business_entity": {
          "id": "<id>",
          "object": "business_entity",
          "links": {
            "self": "/business_entities/<id>"
          }
        },
        "pay_schedule": {
          "id": "<id>",
          "object": "pay_schedule",
          "links": {
            "self": "/pay_schedules/<id>"
          }
        },
        "type": "regular",
        "period_number": 10,
        "period_label": "10",
        "period_start": "2026-10-01",
        "period_end": "2026-10-31",
        "pay_date": "2026-10-30",
        "original_pay_date": "2026-10-31",
        "debit_date": "2026-10-27",
        "approval_due_at": "2026-10-27T20:30:00.000000Z",
        "regular_periods_count": 12,
        "is_impacted_by_weekend_or_holiday": true,
        "is_blocked_by_draft": true,
        "note": null,
        "employee_summary": {
          "gross": null,
          "subtractions": null,
          "reimbursements": null,
          "net": null
        },
        "contractor_summary": {
          "gross": null,
          "reimbursements": null,
          "net": null
        },
        "company_summary": {
          "taxes_and_contributions": null,
          "benefits": null,
          "total": null
        },
        "liability": null,
        "cash_requirement": null,
        "status": "draft",
        "approved_at": null,
        "is_stale": false,
        "stale_since": null,
        "source_payroll": null,
        "warnings": {
          "object": "list",
          "data": []
        },
        "external_ref": null,
        "created_at": "2026-01-01T00:00:00.000000Z",
        "updated_at": "2026-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/payrolls/<id>"
      }
    },
    {
      "id": "<id>",
      "object": "payroll",
      "data": {
        "business_entity": {
          "id": "<id>",
          "object": "business_entity",
          "links": {
            "self": "/business_entities/<id>"
          }
        },
        "pay_schedule": {
          "id": "<id>",
          "object": "pay_schedule",
          "links": {
            "self": "/pay_schedules/<id>"
          }
        },
        "type": "regular",
        "period_number": 11,
        "period_label": "11",
        "period_start": "2026-11-01",
        "period_end": "2026-11-30",
        "pay_date": "2026-11-30",
        "original_pay_date": "2026-11-30",
        "debit_date": "2026-11-25",
        "approval_due_at": "2026-11-25T21:30:00.000000Z",
        "regular_periods_count": 12,
        "is_impacted_by_weekend_or_holiday": false,
        "is_blocked_by_draft": true,
        "note": null,
        "employee_summary": {
          "gross": null,
          "subtractions": null,
          "reimbursements": null,
          "net": null
        },
        "contractor_summary": {
          "gross": null,
          "reimbursements": null,
          "net": null
        },
        "company_summary": {
          "taxes_and_contributions": null,
          "benefits": null,
          "total": null
        },
        "liability": null,
        "cash_requirement": null,
        "status": "draft",
        "approved_at": null,
        "is_stale": false,
        "stale_since": null,
        "source_payroll": null,
        "warnings": {
          "object": "list",
          "data": []
        },
        "external_ref": null,
        "created_at": "2026-01-01T00:00:00.000000Z",
        "updated_at": "2026-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/payrolls/<id>"
      }
    },
    {
      "id": "<id>",
      "object": "payroll",
      "data": {
        "business_entity": {
          "id": "<id>",
          "object": "business_entity",
          "links": {
            "self": "/business_entities/<id>"
          }
        },
        "pay_schedule": {
          "id": "<id>",
          "object": "pay_schedule",
          "links": {
            "self": "/pay_schedules/<id>"
          }
        },
        "type": "regular",
        "period_number": 12,
        "period_label": "12",
        "period_start": "2026-12-01",
        "period_end": "2026-12-31",
        "pay_date": "2026-12-31",
        "original_pay_date": "2026-12-31",
        "debit_date": "2026-12-24",
        "approval_due_at": "2026-12-24T21:30:00.000000Z",
        "regular_periods_count": 12,
        "is_impacted_by_weekend_or_holiday": false,
        "is_blocked_by_draft": true,
        "note": null,
        "employee_summary": {
          "gross": null,
          "subtractions": null,
          "reimbursements": null,
          "net": null
        },
        "contractor_summary": {
          "gross": null,
          "reimbursements": null,
          "net": null
        },
        "company_summary": {
          "taxes_and_contributions": null,
          "benefits": null,
          "total": null
        },
        "liability": null,
        "cash_requirement": null,
        "status": "draft",
        "approved_at": null,
        "is_stale": false,
        "stale_since": null,
        "source_payroll": null,
        "warnings": {
          "object": "list",
          "data": []
        },
        "external_ref": null,
        "created_at": "2026-01-01T00:00:00.000000Z",
        "updated_at": "2026-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/payrolls/<id>"
      }
    },
    {
      "id": "<id>",
      "object": "payroll",
      "data": {
        "business_entity": {
          "id": "<id>",
          "object": "business_entity",
          "links": {
            "self": "/business_entities/<id>"
          }
        },
        "pay_schedule": {
          "id": "<id>",
          "object": "pay_schedule",
          "links": {
            "self": "/pay_schedules/<id>"
          }
        },
        "type": "regular",
        "period_number": 1,
        "period_label": "1",
        "period_start": "2027-01-01",
        "period_end": "2027-01-31",
        "pay_date": "2027-01-29",
        "original_pay_date": "2027-01-31",
        "debit_date": "2027-01-26",
        "approval_due_at": "2027-01-26T21:30:00.000000Z",
        "regular_periods_count": 12,
        "is_impacted_by_weekend_or_holiday": true,
        "is_blocked_by_draft": true,
        "note": null,
        "employee_summary": {
          "gross": null,
          "subtractions": null,
          "reimbursements": null,
          "net": null
        },
        "contractor_summary": {
          "gross": null,
          "reimbursements": null,
          "net": null
        },
        "company_summary": {
          "taxes_and_contributions": null,
          "benefits": null,
          "total": null
        },
        "liability": null,
        "cash_requirement": null,
        "status": "draft",
        "approved_at": null,
        "is_stale": false,
        "stale_since": null,
        "source_payroll": null,
        "warnings": {
          "object": "list",
          "data": []
        },
        "external_ref": null,
        "created_at": "2026-01-01T00:00:00.000000Z",
        "updated_at": "2026-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/payrolls/<id>"
      }
    }
  ],
  "links": {
    "first": "/payrolls?business_entity_id=<id>&period_start%5Bgte%5D=2026-06-01&page=1",
    "last": "/payrolls?business_entity_id=<id>&period_start%5Bgte%5D=2026-06-01&page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 15,
    "total": 8,
    "has_more": false
  }
}

GET

payrolls

List payrolls

curl --request GET \
  --url https://sandbox.nmbr.co/services/payroll/payrolls \
  --header 'Authorization: Bearer <token>'

{
  "object": "list",
  "data": [
    {
      "id": "<id>",
      "object": "payroll",
      "data": {
        "business_entity": {
          "id": "<id>",
          "object": "business_entity",
          "links": {
            "self": "/business_entities/<id>"
          }
        },
        "pay_schedule": {
          "id": "<id>",
          "object": "pay_schedule",
          "links": {
            "self": "/pay_schedules/<id>"
          }
        },
        "type": "regular",
        "period_number": 6,
        "period_label": "6",
        "period_start": "2026-06-01",
        "period_end": "2026-06-30",
        "pay_date": "2026-06-30",
        "original_pay_date": "2026-06-30",
        "debit_date": "2026-06-25",
        "approval_due_at": "2026-06-25T20:30:00.000000Z",
        "regular_periods_count": 12,
        "is_impacted_by_weekend_or_holiday": false,
        "is_blocked_by_draft": true,
        "note": null,
        "employee_summary": {
          "gross": null,
          "subtractions": null,
          "reimbursements": null,
          "net": null
        },
        "contractor_summary": {
          "gross": null,
          "reimbursements": null,
          "net": null
        },
        "company_summary": {
          "taxes_and_contributions": null,
          "benefits": null,
          "total": null
        },
        "liability": null,
        "cash_requirement": null,
        "status": "draft",
        "approved_at": null,
        "is_stale": false,
        "stale_since": null,
        "source_payroll": null,
        "warnings": {
          "object": "list",
          "data": []
        },
        "external_ref": null,
        "created_at": "2026-01-01T00:00:00.000000Z",
        "updated_at": "2026-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/payrolls/<id>"
      }
    },
    {
      "id": "<id>",
      "object": "payroll",
      "data": {
        "business_entity": {
          "id": "<id>",
          "object": "business_entity",
          "links": {
            "self": "/business_entities/<id>"
          }
        },
        "pay_schedule": {
          "id": "<id>",
          "object": "pay_schedule",
          "links": {
            "self": "/pay_schedules/<id>"
          }
        },
        "type": "regular",
        "period_number": 7,
        "period_label": "7",
        "period_start": "2026-07-01",
        "period_end": "2026-07-31",
        "pay_date": "2026-07-31",
        "original_pay_date": "2026-07-31",
        "debit_date": "2026-07-28",
        "approval_due_at": "2026-07-28T20:30:00.000000Z",
        "regular_periods_count": 12,
        "is_impacted_by_weekend_or_holiday": false,
        "is_blocked_by_draft": true,
        "note": null,
        "employee_summary": {
          "gross": null,
          "subtractions": null,
          "reimbursements": null,
          "net": null
        },
        "contractor_summary": {
          "gross": null,
          "reimbursements": null,
          "net": null
        },
        "company_summary": {
          "taxes_and_contributions": null,
          "benefits": null,
          "total": null
        },
        "liability": null,
        "cash_requirement": null,
        "status": "draft",
        "approved_at": null,
        "is_stale": false,
        "stale_since": null,
        "source_payroll": null,
        "warnings": {
          "object": "list",
          "data": []
        },
        "external_ref": null,
        "created_at": "2026-01-01T00:00:00.000000Z",
        "updated_at": "2026-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/payrolls/<id>"
      }
    },
    {
      "id": "<id>",
      "object": "payroll",
      "data": {
        "business_entity": {
          "id": "<id>",
          "object": "business_entity",
          "links": {
            "self": "/business_entities/<id>"
          }
        },
        "pay_schedule": {
          "id": "<id>",
          "object": "pay_schedule",
          "links": {
            "self": "/pay_schedules/<id>"
          }
        },
        "type": "regular",
        "period_number": 8,
        "period_label": "8",
        "period_start": "2026-08-01",
        "period_end": "2026-08-31",
        "pay_date": "2026-08-31",
        "original_pay_date": "2026-08-31",
        "debit_date": "2026-08-26",
        "approval_due_at": "2026-08-26T20:30:00.000000Z",
        "regular_periods_count": 12,
        "is_impacted_by_weekend_or_holiday": false,
        "is_blocked_by_draft": true,
        "note": null,
        "employee_summary": {
          "gross": null,
          "subtractions": null,
          "reimbursements": null,
          "net": null
        },
        "contractor_summary": {
          "gross": null,
          "reimbursements": null,
          "net": null
        },
        "company_summary": {
          "taxes_and_contributions": null,
          "benefits": null,
          "total": null
        },
        "liability": null,
        "cash_requirement": null,
        "status": "draft",
        "approved_at": null,
        "is_stale": false,
        "stale_since": null,
        "source_payroll": null,
        "warnings": {
          "object": "list",
          "data": []
        },
        "external_ref": null,
        "created_at": "2026-01-01T00:00:00.000000Z",
        "updated_at": "2026-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/payrolls/<id>"
      }
    },
    {
      "id": "<id>",
      "object": "payroll",
      "data": {
        "business_entity": {
          "id": "<id>",
          "object": "business_entity",
          "links": {
            "self": "/business_entities/<id>"
          }
        },
        "pay_schedule": {
          "id": "<id>",
          "object": "pay_schedule",
          "links": {
            "self": "/pay_schedules/<id>"
          }
        },
        "type": "regular",
        "period_number": 9,
        "period_label": "9",
        "period_start": "2026-09-01",
        "period_end": "2026-09-30",
        "pay_date": "2026-09-29",
        "original_pay_date": "2026-09-30",
        "debit_date": "2026-09-24",
        "approval_due_at": "2026-09-24T20:30:00.000000Z",
        "regular_periods_count": 12,
        "is_impacted_by_weekend_or_holiday": true,
        "is_blocked_by_draft": true,
        "note": null,
        "employee_summary": {
          "gross": null,
          "subtractions": null,
          "reimbursements": null,
          "net": null
        },
        "contractor_summary": {
          "gross": null,
          "reimbursements": null,
          "net": null
        },
        "company_summary": {
          "taxes_and_contributions": null,
          "benefits": null,
          "total": null
        },
        "liability": null,
        "cash_requirement": null,
        "status": "draft",
        "approved_at": null,
        "is_stale": false,
        "stale_since": null,
        "source_payroll": null,
        "warnings": {
          "object": "list",
          "data": []
        },
        "external_ref": null,
        "created_at": "2026-01-01T00:00:00.000000Z",
        "updated_at": "2026-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/payrolls/<id>"
      }
    },
    {
      "id": "<id>",
      "object": "payroll",
      "data": {
        "business_entity": {
          "id": "<id>",
          "object": "business_entity",
          "links": {
            "self": "/business_entities/<id>"
          }
        },
        "pay_schedule": {
          "id": "<id>",
          "object": "pay_schedule",
          "links": {
            "self": "/pay_schedules/<id>"
          }
        },
        "type": "regular",
        "period_number": 10,
        "period_label": "10",
        "period_start": "2026-10-01",
        "period_end": "2026-10-31",
        "pay_date": "2026-10-30",
        "original_pay_date": "2026-10-31",
        "debit_date": "2026-10-27",
        "approval_due_at": "2026-10-27T20:30:00.000000Z",
        "regular_periods_count": 12,
        "is_impacted_by_weekend_or_holiday": true,
        "is_blocked_by_draft": true,
        "note": null,
        "employee_summary": {
          "gross": null,
          "subtractions": null,
          "reimbursements": null,
          "net": null
        },
        "contractor_summary": {
          "gross": null,
          "reimbursements": null,
          "net": null
        },
        "company_summary": {
          "taxes_and_contributions": null,
          "benefits": null,
          "total": null
        },
        "liability": null,
        "cash_requirement": null,
        "status": "draft",
        "approved_at": null,
        "is_stale": false,
        "stale_since": null,
        "source_payroll": null,
        "warnings": {
          "object": "list",
          "data": []
        },
        "external_ref": null,
        "created_at": "2026-01-01T00:00:00.000000Z",
        "updated_at": "2026-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/payrolls/<id>"
      }
    },
    {
      "id": "<id>",
      "object": "payroll",
      "data": {
        "business_entity": {
          "id": "<id>",
          "object": "business_entity",
          "links": {
            "self": "/business_entities/<id>"
          }
        },
        "pay_schedule": {
          "id": "<id>",
          "object": "pay_schedule",
          "links": {
            "self": "/pay_schedules/<id>"
          }
        },
        "type": "regular",
        "period_number": 11,
        "period_label": "11",
        "period_start": "2026-11-01",
        "period_end": "2026-11-30",
        "pay_date": "2026-11-30",
        "original_pay_date": "2026-11-30",
        "debit_date": "2026-11-25",
        "approval_due_at": "2026-11-25T21:30:00.000000Z",
        "regular_periods_count": 12,
        "is_impacted_by_weekend_or_holiday": false,
        "is_blocked_by_draft": true,
        "note": null,
        "employee_summary": {
          "gross": null,
          "subtractions": null,
          "reimbursements": null,
          "net": null
        },
        "contractor_summary": {
          "gross": null,
          "reimbursements": null,
          "net": null
        },
        "company_summary": {
          "taxes_and_contributions": null,
          "benefits": null,
          "total": null
        },
        "liability": null,
        "cash_requirement": null,
        "status": "draft",
        "approved_at": null,
        "is_stale": false,
        "stale_since": null,
        "source_payroll": null,
        "warnings": {
          "object": "list",
          "data": []
        },
        "external_ref": null,
        "created_at": "2026-01-01T00:00:00.000000Z",
        "updated_at": "2026-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/payrolls/<id>"
      }
    },
    {
      "id": "<id>",
      "object": "payroll",
      "data": {
        "business_entity": {
          "id": "<id>",
          "object": "business_entity",
          "links": {
            "self": "/business_entities/<id>"
          }
        },
        "pay_schedule": {
          "id": "<id>",
          "object": "pay_schedule",
          "links": {
            "self": "/pay_schedules/<id>"
          }
        },
        "type": "regular",
        "period_number": 12,
        "period_label": "12",
        "period_start": "2026-12-01",
        "period_end": "2026-12-31",
        "pay_date": "2026-12-31",
        "original_pay_date": "2026-12-31",
        "debit_date": "2026-12-24",
        "approval_due_at": "2026-12-24T21:30:00.000000Z",
        "regular_periods_count": 12,
        "is_impacted_by_weekend_or_holiday": false,
        "is_blocked_by_draft": true,
        "note": null,
        "employee_summary": {
          "gross": null,
          "subtractions": null,
          "reimbursements": null,
          "net": null
        },
        "contractor_summary": {
          "gross": null,
          "reimbursements": null,
          "net": null
        },
        "company_summary": {
          "taxes_and_contributions": null,
          "benefits": null,
          "total": null
        },
        "liability": null,
        "cash_requirement": null,
        "status": "draft",
        "approved_at": null,
        "is_stale": false,
        "stale_since": null,
        "source_payroll": null,
        "warnings": {
          "object": "list",
          "data": []
        },
        "external_ref": null,
        "created_at": "2026-01-01T00:00:00.000000Z",
        "updated_at": "2026-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/payrolls/<id>"
      }
    },
    {
      "id": "<id>",
      "object": "payroll",
      "data": {
        "business_entity": {
          "id": "<id>",
          "object": "business_entity",
          "links": {
            "self": "/business_entities/<id>"
          }
        },
        "pay_schedule": {
          "id": "<id>",
          "object": "pay_schedule",
          "links": {
            "self": "/pay_schedules/<id>"
          }
        },
        "type": "regular",
        "period_number": 1,
        "period_label": "1",
        "period_start": "2027-01-01",
        "period_end": "2027-01-31",
        "pay_date": "2027-01-29",
        "original_pay_date": "2027-01-31",
        "debit_date": "2027-01-26",
        "approval_due_at": "2027-01-26T21:30:00.000000Z",
        "regular_periods_count": 12,
        "is_impacted_by_weekend_or_holiday": true,
        "is_blocked_by_draft": true,
        "note": null,
        "employee_summary": {
          "gross": null,
          "subtractions": null,
          "reimbursements": null,
          "net": null
        },
        "contractor_summary": {
          "gross": null,
          "reimbursements": null,
          "net": null
        },
        "company_summary": {
          "taxes_and_contributions": null,
          "benefits": null,
          "total": null
        },
        "liability": null,
        "cash_requirement": null,
        "status": "draft",
        "approved_at": null,
        "is_stale": false,
        "stale_since": null,
        "source_payroll": null,
        "warnings": {
          "object": "list",
          "data": []
        },
        "external_ref": null,
        "created_at": "2026-01-01T00:00:00.000000Z",
        "updated_at": "2026-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/payrolls/<id>"
      }
    }
  ],
  "links": {
    "first": "/payrolls?business_entity_id=<id>&period_start%5Bgte%5D=2026-06-01&page=1",
    "last": "/payrolls?business_entity_id=<id>&period_start%5Bgte%5D=2026-06-01&page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 15,
    "total": 8,
    "has_more": false
  }
}

Authorizations

Authorization

string

header

required

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

Query Parameters

business_entity_id

string

The business_entity_id field is required when pay_schedule_id is not present.

pay_schedule_id

string

The pay_schedule_id field is required when business_entity_id is not present.

next_payrolls

enum<string>

Allows for restricting to only next payrolls, or to exclude any next payrolls. A payroll is the next payroll within a single PaySchedule, if it has a status of draft, approved, processing, or failed.

If an off_cycle payroll has been created, the next off_cycle payroll with a status of draft, approved, processing, or failed will also be returned by default.

Available options:

exclude,

only

source_payroll_in_year

string

If a year is passed, the payrolls will be restricted to only those which can be used as the source_payroll_id on an off_cycle payroll.

type

enum<string>

Available options:

correction,

historical,

off_cycle,

regular

status

enum<string>

Available options:

approved,

draft,

failed,

paid,

partially_paid,

processing

period_start

object

Date filters support two formats: Exact Date Match: Provide a well-formatted date in YYYY-MM-DD format for an exact match. Example: period_start=2024-01-01 Use an array-like syntax to specify a range with one or more comparison operators:

gt (greater than)
gte (greater than or equal to)
lte (less than or equal to)
lt (less than) Example: period_start[gte]=2024-01-01&period_start[lt]=2024-12-31

period_end

object

Date filters support two formats: Exact Date Match: Provide a well-formatted date in YYYY-MM-DD format for an exact match. Example: period_end=2024-01-01 Use an array-like syntax to specify a range with one or more comparison operators:

gt (greater than)
gte (greater than or equal to)
lte (less than or equal to)
lt (less than) Example: period_end[gte]=2024-01-01&period_end[lt]=2024-12-31

pay_date

object

Date filters support two formats: Exact Date Match: Provide a well-formatted date in YYYY-MM-DD format for an exact match. Example: pay_date=2024-01-01 Use an array-like syntax to specify a range with one or more comparison operators:

gt (greater than)
gte (greater than or equal to)
lte (less than or equal to)
lt (less than) Example: pay_date[gte]=2024-01-01&pay_date[lt]=2024-12-31

external_ref

string

sort

enum<string>

Sort order is specified using the format sort=field[:direction][,field[:direction],...] where field is the name of the field to sort by and direction is the optional sort direction (asc or desc).

Available options:

pay_date,

pay_schedule_id,

period_end,

period_start

expand

enum<string>[]

Available options:

business_entity,

pay_schedule,

pay_stubs,

source_payroll

Response

200 - application/json

object

string

read-only

The type of the object in Nmbr ("list").

data

object[]

Hide child attributes

data.id

string

read-only

The unique identifier of the object in Nmbr.

data.object

string

read-only

The type of the object in Nmbr ("payroll").

data.data

Default · object

Default
With business_entity expanded
With pay_schedule expanded
With pay_stubs expanded
With source_payroll expanded

Hide child attributes

data.data.business_entity

object

Hide child attributes

data.data.business_entity.id

string

read-only

The unique identifier of the object in Nmbr.

data.data.business_entity.object

string

read-only

The type of the object in Nmbr ("business_entity").

data.data.pay_schedule

object

Hide child attributes

data.data.pay_schedule.id

string

read-only

The unique identifier of the object in Nmbr.

data.data.pay_schedule.object

string

read-only

The type of the object in Nmbr ("pay_schedule").

data.data.type

enum<string>

The type of payroll. regular payrolls are generated automatically on the Pay Schedule. off_cycle Payrolls are created manually against a source regular payroll. historical and correction payrolls are used to record or correct prior periods.

Available options:

correction,

historical,

off_cycle,

regular

data.data.period_number

integer | null

The sequential number of this pay period within the calendar year of its pay_date, counting only regular payrolls. null for off-cycle, historical, and correction payrolls.

data.data.period_label

string | null

A human-readable label for this pay period.

data.data.period_start

string<date>

The start date of the pay period.

data.data.period_end

string<date>

The end date of the pay period.

data.data.pay_date

string<date>

The date on which Employees and Contractors are paid.

data.data.original_pay_date

string<date> | null

For payrolls on a custom-frequency Pay Schedule, the originally scheduled pay date before any movement for weekends or bank holidays. Used for year-to-date calculations and tax year assignment.

data.data.debit_date

string | null

The expected date the company's account will be debited the cash_requirement amount.

data.data.approval_due_at

string<dateTime> | null

read-only

The date and time, in UTC, by which the payroll must be approved to be processed on time.

data.data.regular_periods_count

integer | null

The total number of regular pay periods in this Pay Schedule whose pay_date falls in the same calendar year as this payroll's pay_date. Used for year-to-date calculations.

data.data.is_impacted_by_weekend_or_holiday

boolean

Whether pay_date or approval_due_at has been moved to avoid falling on a weekend or bank holiday.

data.data.is_blocked_by_draft

boolean

Whether this payroll is blocked from being approved because an earlier payroll on the same Pay Schedule is still in draft status.

data.data.note

string | null

An optional note on the payroll, visible to the partner.

data.data.employee_summary

object

A summary of pay across all Employees in this payroll.

Hide child attributes

data.data.employee_summary.gross

any

The sum of all earnings and allowances.

data.data.employee_summary.subtractions

any

The total of all deductions, taxes, and benefit contributions.

data.data.employee_summary.reimbursements

any

The total of non-taxable reimbursements.

data.data.employee_summary.net

any

The Employee net pay; when negative, a warning is included.

data.data.contractor_summary

object

A summary of pay across all Contractors in this payroll.

Hide child attributes

data.data.contractor_summary.gross

any

The sum of all earnings.

data.data.contractor_summary.reimbursements

any

The total of non-taxable reimbursements.

data.data.contractor_summary.net

any

The Contractor net pay.

data.data.company_summary

object

A summary of the company's obligations in this payroll.

Hide child attributes

data.data.company_summary.taxes_and_contributions

any

The employer share of statutory remittances (CPP and EI).

data.data.company_summary.benefits

any

The total of employer benefit contributions.

data.data.company_summary.total

any

The company's total obligations.

data.data.liability

number<decimal> | null

The total amount owed by the company for this payroll, including Employee and Contractor net pay, employer tax contributions, and employer benefit contributions.

data.data.cash_requirement

number<decimal> | null

The total amount that will be debited from the company's account when this payroll is approved.

data.data.status

enum<string>

The current status of the payroll.

Available options:

approved,

draft,

failed,

paid,

partially_paid,

processing

data.data.approved_at

string<date> | null

The date on which the payroll was approved.

data.data.is_stale

boolean

Whether the payroll's tax calculations are out of date. When true, stale_since indicates when the payroll became stale.

data.data.stale_since

string<dateTime> | null

read-only

The timestamp at which the payroll's tax calculations became stale and need to be recalculated. null if the payroll is up to date.

data.data.source_payroll

any

data.data.warnings

object

A collection of data validation warnings for this payroll. Warnings indicate incomplete or potentially incorrect data and could prevent payroll processing.

Hide child attributes

data.data.warnings.object

string | null

data.data.warnings.data

object

data.data.external_ref

string | null

A reference to the object in an external system, e.g. the primary key of the object in your application's database. Nmbr doesn't use, validate, parse, or require this value to be unique - it simply stores it for your reference.

Maximum string length: 255

data.data.created_at

string<dateTime>

read-only

The date and time the object was created in Nmbr.

data.data.updated_at

string<dateTime>

read-only

The date and time the object was last updated in Nmbr.

Delete a pay schedule Create a payroll

⌘I