Skip to main content
POST
/
v1
/
benefit
/
elections
/
{id}
/
terminate
Terminate a benefit election
curl --request POST \
  --url https://api.plane.com/v1/benefit/elections/{id}/terminate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ends": "<string>"
}
'
{
  "id": "bele_W7oQ4rS0uZ3n",
  "object": "benefit.election",
  "worker": "wrkr_daniel",
  "plan": "benpl_V6nP3qR9tY2m",
  "coverage": "employee_only",
  "status": "terminated",
  "contribution": {},
  "starts": null,
  "ends": "2026-05-29",
  "metadata": {},
  "created": "2026-05-29T12:00:00Z",
  "updated": "2026-05-29T12:00:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.plane.com/llms.txt

Use this file to discover all available pages before exploring further.

Terminate an active election to end the worker’s coverage. The election is not deleted — it stays on record with status terminated and an ends date, so the coverage history is preserved. To switch a worker to a different plan, terminate the current election and create a new one.

​
Parameters

​
id
string
required
ID of the benefit election.
​
ends
string
Last day the coverage is in effect. Defaults to today.

​
Returns

Returns the terminated Benefit election object. 
{
  "id": "bele_W7oQ4rS0uZ3n",
  "object": "benefit.election",
  "worker": "wrkr_daniel",
  "plan": "benpl_V6nP3qR9tY2m",
  "coverage": "employee_only",
  "status": "terminated",
  "contribution": {},
  "starts": null,
  "ends": "2026-05-29",
  "metadata": {},
  "created": "2026-05-29T12:00:00Z",
  "updated": "2026-05-29T12:00:00Z"
}