---
search:
  tags:
    - organization-reads
    - POST
seo:
  description: >-
    Get private lesson requests waiting on someone and the… Reference for the
    POST /queries/get_private_lessons_overview endpoint in the Soljio
    Organization API.
sidebar:
  label: >-
    Get private lesson requests waiting on someone and the lessons in a range of
    up to two weeks.
  badge: POST
title: >-
  Get private lesson requests waiting on someone and the lessons in a range of
  up to two weeks.
type: openapi-operation
---
Get private lesson requests waiting on someone and the lessons in a range of up to two weeks. An organization-scoped read using JSON filter arguments; requires private_lessons.read. Pagination cursors must be reused only with the same organization, operation and filters.

`POST /queries/get_private_lessons_overview`

**Request body** (`application/json`, required)

- `ends_at` (string<date-time>, required)
- `instructor_id` (string) — Opaque Soljio resource ID.
- `mine` (boolean)
- `starts_at` (string<date-time>, required)

Request body example:

```json
{
  "ends_at": "2019-08-24T14:15:22Z",
  "instructor_id": "string",
  "mine": true,
  "starts_at": "2019-08-24T14:15:22Z"
}
```

**Responses**

- `200` — Successful read.
- `400` — invalid\_request
- `401` — unauthorized
- `403` — forbidden
- `404` — not\_found
- `405` — method\_not\_allowed
- `409` — conflict, idempotency\_conflict
- `413` — payload\_too\_large
- `415` — unsupported\_media\_type
- `429` — rate\_limited
- `500` — internal\_error

Response example, 200:

```json
{
  "data": {
    "change_requests": [
      {
        "booking_id": "string",
        "from_starts_at": "2019-08-24T14:15:22Z",
        "household_name": "string",
        "lesson_count": 0,
        "lesson_type_name": "string",
        "requested_at": "2019-08-24T14:15:22Z",
        "timezone": "string",
        "to_starts_at": "2019-08-24T14:15:22Z"
      }
    ],
    "instructors": [
      {
        "id": "string",
        "name": "string"
      }
    ],
    "lessons": [
      {
        "balance_minor": 0,
        "booking_id": "string",
        "booking_status": "invitation",
        "cancel_reason": "string",
        "cash_amount_minor": 0,
        "credits": 0,
        "currency": "string",
        "ends_at": "2019-08-24T14:15:22Z",
        "guest_count": 0,
        "household_name": "string",
        "id": "string",
        "instructor_id": "string",
        "instructor_name": "string",
        "lesson_type_name": "string",
        "location_id": "string",
        "location_name": "string",
        "starts_at": "2019-08-24T14:15:22Z",
        "status": "reserved",
        "students": [
          {
            "id": "string",
            "name": "string"
          }
        ],
        "timezone": "string",
        "total_amount_minor": 0
      }
    ],
    "requests": [
      {
        "balance_minor": 0,
        "booking_id": "string",
        "currency": "string",
        "deadline": 0,
        "first_starts_at": "2019-08-24T14:15:22Z",
        "guest_count": 0,
        "household_name": "string",
        "lesson_count": 0,
        "lesson_type_name": "string",
        "status": "invitation",
        "student_names": [
          "string"
        ],
        "timezone": "string"
      }
    ],
    "setup": {
      "has_opening_hours": true,
      "lesson_types": 0,
      "published": 0
    },
    "timezone": "string"
  },
  "request_id": "266ea41d-adf5-480b-af50-15b940c2b846"
}
```

Response example, 400:

```json
{
  "error": {
    "code": "invalid_request",
    "message": "The request is invalid."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 401:

```json
{
  "error": {
    "code": "unauthorized",
    "message": "A valid service token is required."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 403:

```json
{
  "error": {
    "code": "forbidden",
    "message": "The service token lacks a required scope."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 404:

```json
{
  "error": {
    "code": "not_found",
    "message": "The requested resource was not found."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 405:

```json
{
  "error": {
    "code": "method_not_allowed",
    "message": "The method is not supported for this resource."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 409:

```json
{
  "error": {
    "code": "conflict",
    "message": "The command conflicts with the current state."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 413:

```json
{
  "error": {
    "code": "payload_too_large",
    "message": "The request body exceeds the byte limit for this operation."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 415:

```json
{
  "error": {
    "code": "unsupported_media_type",
    "message": "Use application/json for command requests."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 429:

```json
{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Retry after the indicated delay."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 500:

```json
{
  "error": {
    "code": "internal_error",
    "message": "The request could not be completed."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```
