---
title: "Get suggestions"
method: GET
path: "/api/v1/suggestions"
tags: ["Comments & Suggestions "]
---

# Get suggestions

`GET /api/v1/suggestions`

## Request

- Base URL: `https://api.simplelocalize.io`
- URL: `https://api.simplelocalize.io/api/v1/suggestions`
- Auth: one of:
  - API key in header `X-SimpleLocalize-Token`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/simplelocalize/apis/simplelocalize-api/docs/api/v1/suggestions/get.ts> (a function with typed inputs; its response is checked against the schema)

Gets translation suggestions for a given key and language.

The `Authorization` header with a Personal Access Token is optional here.

## Query parameters

- `namespace` string
- `key` string, required
- `language` string, required
- `page` integer
- `size` integer

## Headers

- `X-SimpleLocalize-Token` string, required
- `Authorization` string

## Response `200`

OK

- object
  - `msg` string
  - `status` integer
  - `data` PagedModelCommentResponse
    - `content` CommentResponse[]
      - `id` string
      - `content` string
      - `votes` integer
      - `userVote` integer
      - `suggestedTranslation` string
      - `suggestedTranslationApprovedAt` string, date-time
      - `author` CommentAuthor
        - `name` string
        - `email` string
        - `role` string
        - `profileImageUrl` string
        - `isAnonymous` boolean
      - `createdAt` string, date-time
      - `deletedAt` string, date-time
      - `canDelete` boolean
      - `canModify` boolean
      - `canIgnore` boolean
      - `modifiedAt` string, date-time
      - `ignoredAt` string, date-time
      - `link` string
      - `namespace` string
      - `translationKey` string
      - `languageKey` string
    - `page` PageMetadata
      - `size` integer
      - `number` integer
      - `totalElements` integer
      - `totalPages` integer

## Other responses

- `400`: Bad Request
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `429`: Too Many Requests
- `500`: Internal Server Error

## Changes

- **2026-11-07** `67a25a25863a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/simplelocalize/apis/simplelocalize-api/changes/api/v1/suggestions/get.md)

---

[API](https://skmtc.dev/simplelocalize/apis/simplelocalize-api.md) - [All operations](https://skmtc.dev/simplelocalize/apis/simplelocalize-api/llms.txt) - [OpenAPI document](https://skmtc.dev/simplelocalize/apis/simplelocalize-api/revisions/67a25a25863a?raw)