# Get All Unit Offerings

**GET /api/v1/unit-offerings**

Retrieve all unit offerings with optional filtering by course intake, lecturer, semester, or unit version. Supports search by offering code.


## Servers
- Local server: http://localhost:3500 (Local server)
- Production server: https://api.echoplain.social (Production server)



## Parameters


### Query parameters
- **courseIntakeId** (string)
  Filter by course intake ID
- **lecturerId** (string)
  Filter by lecturer ID
- **semesterId** (string)
  Filter by semester ID
- **unitVersionId** (string)
  Filter by unit version ID
- **codeSearch** (string)
  Search by unit offering code (partial match)
- **status** (string)
  Filter by status


## Responses
### 200
Unit offerings retrieved successfully

#### Body: application/json (object)
- **message** (string)
  Response message
- **total** (number)
  Total number of unit offerings
- **offerings** (array[object])
  List of unit offerings

### 400
Default bad request error 400 response

#### Body: application/json (object)
- **message** (string)
  Response message
- **error** (string)

- **statusCode** (number)


### 401
Authentication required

### 403
Admin or Lecturer privileges required


[Powered by Bump.sh](https://bump.sh)