# List Project Offering Role Plans

Lists paginated planned time entries for a Project Offering Role with filtering by date range. Days with no planned hours are not returned.

Endpoint: GET /v1/projects/{project_id}/offerings/{project_offering_id}/roles/{id}/planned-time
Version: v1
Security: ApiKey

## Path parameters:

  - `id` (string, required)
    ID of the resource

  - `project_id` (string, required)

  - `project_offering_id` (string, required)

## Query parameters:

  - `page` (integer)
    The specific page of results requested.

  - `page_size` (integer)
    The number of results in each page.

  - `start_date` (string)
    Filter by entries recorded on or after this date. ISO date formatting expected (yyyy-MM-dd)

  - `end_date` (string)
    Filter by entries recorded on or before this date. ISO date formatting expected (yyyy-MM-dd)

## Response 200 fields (application/json):

  - `count` (integer)
    The number of results in the current page.

  - `total` (integer)
    The total number of results that fulfill the request.

  - `page` (integer)
    The current page of results being returned.

  - `total_pages` (integer)
    The total number of available pages that fulfill the request.

  - `page_size` (integer)
    The number of results in each page returned.

  - `results` (array, required)
    The array of result objects for the current page.

  - `results.plan_date` (string, required)
    The date in which the actual time entry is recorded to, in the YYYY-MM-DD format.

  - `results.hours` (number, required)
    The number of hours associated with the planned time entry.

## Response 400 fields (application/json):

  - `type` (string)
    RFC reference for the error type

  - `title` (string)
    Human-readable summary of the error

  - `status` (integer)
    HTTP status code

  - `errors` (array)
    Detailed error messages for each validation failure

  - `trace_id` (string)
    Trace identifier for debugging