---
title: "List grades"
method: POST
path: "/v2/companies/{companyId}/grades/list"
tags: ["Grades"]
---

# List grades

`POST /v2/companies/{companyId}/grades/list`

This endpoint lists grades of a company.

## Request body

- ListGradesRequest — List grades request
  - `searchText` string — Search string entered by the user
  - `paginationParams` OffsetBasedPaginationRequestParams, required — Pagination parameters for requests.
    - `offset` integer — The starting index in the list from which results are returned. The value must be greater than or equal to 0.
    - `limit` integer — Maximum number of results to be fetched.
  - `filters` ListGradesFilter[] — List of filters. Grades matching with any filter would be returned.
    - `gradeIds` string[] — List of grade ids.

## Response `200`

OK

- ListGradesResponse — Response for list grades API.
  - `paginationParams` OffsetBasedPaginationResponseParams, required — Pagination parameters for response.
    - `totalNumResults` integer, required — Total number of results.
  - `grades` GradeInfo[] — List of grades containing id and name.
    - `id` string, uuid, required
    - `name` string

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — The specified resource was not found.

---

[API](https://skmtc.net/spotnana/apis/company-api.md) · [All operations](https://skmtc.net/spotnana/apis/company-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spotnana/company-api/revisions/fc09f0cd1f4d/schema)