---
title: "List Calendar Event/Task Statuses"
method: GET
path: "/admin/calendar_entry_statuses"
tags: ["Calendar Event/Task Statuses"]
---

# List Calendar Event/Task Statuses

`GET /admin/calendar_entry_statuses`

## Request

- Base URL: `https://api.pipelinecrm.com/api/v3`
- URL: `https://api.pipelinecrm.com/api/v3/admin/calendar_entry_statuses`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer and API key in header `app-key`
  - API key in query parameter `api_key` and API key in query parameter `app_key`

Retrieve all calendar entry statuses for the current account, ordered by position.

Each account has two system statuses that are automatically created:
- **To-Do** (`status_type: todo`): Always appears first (position 1)
- **Done** (`status_type: done`): Always appears last

Custom statuses (`status_type: custom`) appear between these system statuses and can be reordered.

## Response `200`

Successful Response

- CalendarEntryStatusList
  - `pagination` Pagination, required: Paging details returned alongside `entries` on every paginated list.
    - `page` integer: The page returned. Request another with `?page=N`.
    - `per_page` integer: Page size. `?per_page=N`, capped at 200.
    - `total` integer: Total number of records matching the request across all pages.
    - `pages` integer: Number of pages at this `per_page`.
    - `total_in_account` integer, nullable: Total number of records of this type visible to you before filters were applied. Null when not computed for the endpoint.
    - `page_var` string: Name of the query parameter that selects the page. Always `page`.
    - `url` string, nullable: Path of the request, when the endpoint reports it.
  - `entries` CalendarEntryStatusAll[], required: Paginated calendar entry statuses
    - `id` integer: Unique identifier
    - `in_use` boolean: Whether any calendar entry currently uses this status
    - `created_at` string: Timestamp when the record was created (time zone in user's time zone).
    - `updated_at` string: Timestamp when the record was last touched (time zone in user's time zone).
    - `name` string: The name/label of the calendar entry status. Must be unique within the account.
    - `position` integer: Order position in list of statuses. Automatically managed for system statuses (To-Do and Done).
    - `hex_color` string: The color to display the status (hex code with '#' prefix)
    - `status_type` 'custom' | 'todo' | 'done': The type of status: - `custom`: User-created status (default). Can be reordered, edited, and deleted. - `todo`: System "To-Do" status. Always appears first. Cannot be reordered or deleted. - `done`: System "Done" status. Always appears last. Cannot be reordered or deleted. System statuses (todo/done) are automatically created and maintained per account.

## Other responses

- `400`: The request could not be processed as sent (for example a malformed id or an unsupported combination of parameters).

---

[API](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api.md) · [All operations](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api/revisions/53ebfcc83597?raw)