# List actual hours

Source: https://www.supervisible.com/developers/actual-hours/get-actual-hours

GET /actual-hours



## GET /actual-hours

Returns whole weekly actual totals from 0–168 hours, keyed by Sunday and scoped to your organization. Date ranges include the weeks containing their bounds. Logged hours can exist even when no planned assignment week was created.

Base URL: https://app.supervisible.com/api/v1

Required scope: read:actual_hours

## Operation contract

The definition below includes parameters, request bodies, response schemas, examples and authentication requirements.

```json
{
  "summary": "List actual hours",
  "description": "Returns whole weekly actual totals from 0–168 hours, keyed by Sunday and scoped to your organization. Date ranges include the weeks containing their bounds. Logged hours can exist even when no planned assignment week was created.",
  "tags": [
    "actual-hours"
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "x-required-scope": "read:actual_hours",
  "parameters": [
    {
      "in": "query",
      "name": "user_id",
      "required": false,
      "description": "Filter by user.",
      "schema": {
        "type": "string",
        "description": "UUID"
      }
    },
    {
      "in": "query",
      "name": "project_id",
      "required": false,
      "description": "Filter by project.",
      "schema": {
        "type": "string",
        "description": "UUID"
      }
    },
    {
      "in": "query",
      "name": "start_date",
      "required": false,
      "description": "Include the week containing this date and later weeks.",
      "schema": {
        "type": "string",
        "description": "Date in YYYY-MM-DD format"
      }
    },
    {
      "in": "query",
      "name": "end_date",
      "required": false,
      "description": "Include the week containing this date and earlier weeks.",
      "schema": {
        "type": "string",
        "description": "Date in YYYY-MM-DD format"
      }
    },
    {
      "in": "query",
      "name": "limit",
      "required": false,
      "description": "Number of rows (default 50, max 200).",
      "schema": {
        "type": "number"
      }
    },
    {
      "in": "query",
      "name": "offset",
      "required": false,
      "description": "Pagination offset (default 0).",
      "schema": {
        "type": "number"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successful response",
      "content": {
        "application/json": {
          "example": {
            "data": {}
          }
        }
      }
    },
    "400": {
      "description": "Invalid request"
    },
    "401": {
      "description": "Unauthorized"
    },
    "403": {
      "description": "Missing required scope or current member permission"
    },
    "404": {
      "description": "Not found"
    },
    "409": {
      "description": "Conflict; refresh current state and preview again"
    },
    "429": {
      "description": "Rate limited; honor Retry-After"
    }
  }
}
```

## Referenced definitions

```json
{
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key"
      }
    }
  }
}
```

[Complete OpenAPI specification](https://www.supervisible.com/openapi/public-api-v1.json)