---
title: "Get project contributors"
method: GET
path: "/api/v1/projects/{projectToken}/contributors"
tags: ["Projects"]
---

# Get project contributors

`GET /api/v1/projects/{projectToken}/contributors`

## Request

- Base URL: `https://api.simplelocalize.io`
- URL: `https://api.simplelocalize.io/api/v1/projects/{projectToken}/contributors`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/simplelocalize/apis/simplelocalize-api/docs/api/v1/projects/:projectToken/contributors/get.ts> (a function with typed inputs; its response is checked against the schema)

Get all contributors of the project.
- Requires Personal Token for authentication and the project must be on a paid plan to manage contributors.
- Every contributor has a name, email, status and role.
- Translators can have assigned languages, tags, and customers with access levels.
- Status can be either `ACCEPTED` or `INVITED`.
- Role can be either `TRANSLATOR`, `ADMIN` or `OWNER`.

### Permissions

Available permissions for `TRANSLATOR` role:
- `VIEW_ACTIVITY`
- `IMPORT_FILES`
- `EXPORT_FILES`
- `MANAGE_TRANSLATION_KEYS`
- `MANAGE_LANGUAGES`
- `AUTO_TRANSLATE`
- `CHANGE_TRANSLATIONS`
- `REVIEW_TRANSLATIONS`
- `CHANGE_CUSTOMER_TRANSLATIONS`
- `REVIEW_CUSTOMER_TRANSLATIONS`
- `CHANGE_DESCRIPTION`
- `PUBLISH_TRANSLATIONS`
- `ACCESS_COMMENTS`

Access levels: `ALLOW` and `DENY`.


### Language access levels:
- `WRITE_READ` means the contributor can perform the action.
- `READ` means the contributor can read the translations, but cannot write them.
- `HIDDEN` means the contributor cannot perform the action.


### Tag and Customer access levels:
- `WRITE_READ` means the contributor can perform the action.
- `HIDDEN` means the contributor cannot perform the action.

## Path parameters

- `projectToken` string, required

## Response `200`

OK

- object
  - `msg` string
  - `status` integer
  - `data` ApiProjectContributor[]
    - `name` string
    - `email` string
    - `status` 'INVITED' | 'ACCEPTED'
    - `role` 'OWNER' | 'ADMIN' | 'DEVELOPER' | 'TRANSLATOR'
    - `permissions` Permission[]
      - `key` 'AUTO_TRANSLATE, CHANGE_TRANSLATIONS, REVIEW_TRANSLATIONS, PUBLISH_TRANSLATIONS, MANAGE_TRANSLATION_KEYS, MANAGE_LANGUAGES, IMPORT_FILES, EXPORT_FILES, VIEW_ACTIVITY, ACCESS_COMMENTS, CHANGE_CUSTOMER_TRANSLATIONS, REVIEW_CUSTOMER_TRANSLATIONS, CHANGE_DESCRIPTION', required: Permission key, e.g. 'AUTO_TRANSLATE'
      - `access` 'ALLOW' | 'DENY', required: Access level for the permission
    - `assignedLanguages` AssignedLanguage[]
      - `key` string, required: Language key, e.g. 'en', 'fr', 'de'
      - `access` 'ALLOW' | 'DENY', required: Access level for the language
    - `defaultLanguageAccess` 'WRITE_READ' | 'READ' | 'HIDDEN'
    - `assignedTags` AssignedTag[]
      - `name` string, required: Tag name
      - `access` 'ALLOW' | 'DENY', required: Access level for the tag
    - `defaultTagAccess` 'WRITE_READ' | 'HIDDEN'
    - `assignedCustomers` AssignedCustomer[]
      - `key` string, required: Customer key
      - `access` 'ALLOW' | 'DENY', required: Access level for the customer
    - `defaultCustomerAccess` 'WRITE_READ' | 'HIDDEN'

## 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`: 2 warning, 1 info
  - added the new `AUTO_TRANSLATE, CHANGE_TRANSLATIONS, REVIEW_TRANSLATIONS, PUBLISH_TRANSLATIONS, MANAGE_TRANSLATION_KEYS, MANAGE_LANGUAGES, IMPORT_FILES, EXPORT_FILES, VIEW_ACTIVITY, ACCESS_COMMENTS, CHANGE_CUSTOMER_TRANSLATIONS, REVIEW_CUSTOMER_TRANSLATIONS, CHANGE_DESCRIPTION` enum value to the `data/items/permissions/items/key` response property for the response status `200`
  - added the new `DEVELOPER` enum value to the `data/items/role` response property for the response status `200`
  - removed the `AUTO_TRANSLATE, CHANGE_TRANSLATIONS, REVIEW_TRANSLATIONS, PUBLISH_TRANSLATIONS, MANAGE_TRANSLATION_KEYS, ADD_LANGUAGES, UPDATE_LANGUAGES, DELETE_LANGUAGES, IMPORT_FILES, EXPORT_FILES, VIEW_ACTIVITY, ACCESS_COMMENTS, CHANGE_CUSTOMER_TRANSLATIONS, REVIEW_CUSTOMER_TRANSLATIONS, CHANGE_DESCRIPTION` enum value from the `data/items/permissions/items/key` response property for the response status `200`
- **2025-11-12** `0329534cd557`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/simplelocalize/apis/simplelocalize-api/changes/api/v1/projects/:projectToken/contributors/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)