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

# List grades

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

## Request

- Base URL: `https://api-ext-sboxmeta.partners.spotnana.com`
- URL: `https://api-ext-sboxmeta.partners.spotnana.com/v2/companies/{companyId}/grades/list`
- Auth: HTTP bearer

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.dev/spotnana/apis/company-api.md) - [All operations](https://skmtc.dev/spotnana/apis/company-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spotnana/apis/company-api/revisions/184a1b415751?raw)