Project

List projects

API call to retrieve a paginated list of projects. Contains a subset of information contained in Get project API call.

Utilize the query parameters below to refine the search criteria:

name - The full project name or a portion of it. For instance, using name=GUI or name=02 will find projects named GUI02.
clientId - The client’s ID within the system, not interchangeable with its UID.
clientName - The complete or partial name of the client. For example, using clientName=GUI or clientName=02 will find projects associated with the client GUI02.
businessUnitId - The business unit’s ID within the system, not interchangeable with its UID.
businessUnitName - The complete or partial name of the business unit. For instance, using businessUnitName=GUI or businessUnitName=02 will find projects linked to the business unit GUI02.
statuses - A list of project statuses. When adding multiple statuses, include each as a dedicated query parameter, e.g., statuses=ASSIGNED&statuses=COMPLETED.
domainId - The domain’s ID within the system, not interchangeable with its UID.
domainName - The complete or partial name of the domain. Using domainName=GUI or domainName=02 will find projects associated with the domain GUI02.
subDomainId - The subdomain’s ID within the system, not interchangeable with its UID.
subDomainName - The complete or partial name of the subdomain. For example, using subDomainName=GUI or subDomainName=02 will find projects linked to the subdomain GUI02.
costCenterId - The cost center’s ID within the system, not interchangeable with its UID.
costCenterName - The complete or partial name of the cost center. For instance, using costCenterName=GUI or costCenterName=02 will find projects associated with the cost center GUI02.
dueInHours - Filter for jobs with due dates less than or equal to the specified number of hours.
createdInLastHours - Filter for jobs created within the specified number of hours.
ownerId - The user ID who owns the project within the system, not interchangeable with its UID.
jobStatuses - A list of statuses for jobs within the projects. Include each status as a dedicated query parameter, e.g., jobStatuses=ASSIGNED&jobStatuses=COMPLETED.
jobStatusGroup - The name of the status group used to filter projects containing at least one job with the specified status, similar to the status filter in the Projects list for a Linguist user.
buyerId - The Buyer’s ID.
pageNumber - Indicates the desired page number (zero-based) to retrieve. The total number of pages is returned in the totalPages field within each response.
pageSize - Indicates the page size, affecting the totalPages retrieved in each response and potentially influencing the number of iterations needed to obtain all projects.
nameOrInternalId - Specify either the project name or Internal ID (the sequence number in the project list displayed in the UI).
includeArchived - A boolean parameter to include archived projects in the search.
archivedOnly - A boolean search indicating whether only archived projects should be searched.

GET

api2

projects

List projects

curl --request GET \
  --url https://cloud.memsource.com/web/api2/v1/projects

{
  "totalElements": 123,
  "totalPages": 123,
  "pageSize": 123,
  "pageNumber": 123,
  "numberOfElements": 123,
  "content": [
    {
      "uid": "<string>",
      "internalId": 123,
      "id": "<string>",
      "name": "<string>",
      "dateCreated": "2023-11-07T05:31:56Z",
      "domain": {
        "name": "<string>",
        "id": "<string>",
        "uid": "<string>"
      },
      "subDomain": {
        "name": "<string>",
        "id": "<string>",
        "uid": "<string>"
      },
      "owner": {
        "firstName": "<string>",
        "lastName": "<string>",
        "userName": "<string>",
        "email": "<string>",
        "role": "SYS_ADMIN",
        "id": "<string>",
        "uid": "<string>"
      },
      "sourceLang": "<string>",
      "targetLangs": [
        "<string>"
      ],
      "references": [
        {
          "id": "<string>",
          "uid": "<string>",
          "filename": "<string>",
          "note": "<string>",
          "dateCreated": "2023-11-07T05:31:56Z",
          "createdBy": {
            "firstName": "<string>",
            "lastName": "<string>",
            "userName": "<string>",
            "email": "<string>",
            "role": "SYS_ADMIN",
            "id": "<string>",
            "uid": "<string>"
          }
        }
      ],
      "mtSettingsPerLanguageList": [
        {
          "targetLang": "<string>",
          "machineTranslateSettings": {
            "id": "<string>",
            "uid": "<string>",
            "name": "<string>",
            "type": "<string>"
          }
        }
      ],
      "userRole": "<string>"
    }
  ],
  "sort": {
    "orders": [
      {
        "direction": "ASC",
        "property": "<string>"
      }
    ]
  }
}

Query Parameters

name

string

clientId

integer

clientName

string

businessUnitId

integer

businessUnitName

string

statuses

enum<string>[]

Show child attributes

targetLangs

string[]

domainId

integer

domainName

string

subDomainId

integer

subDomainName

string

costCenterId

integer

costCenterName

string

dueInHours

integer

-1 for projects that are overdue

Required range: x >= -1

createdInLastHours

integer

Required range: x >= 0

sourceLangs

string[]

ownerId

integer

jobStatuses

enum<string>[]

Allowed for linguists only

Show child attributes

jobStatusGroup

enum<string>

Allowed for linguists only

Available options:

NEW,

ACCEPTED,

COMPLETED

buyerId

integer

pageNumber

integer

default:0

Page number, starting with 0, default 0

Required range: x >= 0

pageSize

integer

default:50

Page size, accepts values between 1 and 50, default 50

Required range: 1 <= x <= 50

nameOrInternalId

string

Name or internal ID of project

includeArchived

boolean

default:false

List also archived projects

archivedOnly

boolean

default:false

List only archived projects, regardless of includeArchived

sort

enum<string>

default:ID

Available options:

INTERNAL_ID,

NAME,

DATE_CREATED,

DATE_ARCHIVED

order

enum<string>

default:ASC

Available options:

ASC,

DESC

Response

200

application/json

successful operation

The response is of type object.

Remove language pair Create project

List projects

curl --request GET \
  --url https://cloud.memsource.com/web/api2/v1/projects

{
  "totalElements": 123,
  "totalPages": 123,
  "pageSize": 123,
  "pageNumber": 123,
  "numberOfElements": 123,
  "content": [
    {
      "uid": "<string>",
      "internalId": 123,
      "id": "<string>",
      "name": "<string>",
      "dateCreated": "2023-11-07T05:31:56Z",
      "domain": {
        "name": "<string>",
        "id": "<string>",
        "uid": "<string>"
      },
      "subDomain": {
        "name": "<string>",
        "id": "<string>",
        "uid": "<string>"
      },
      "owner": {
        "firstName": "<string>",
        "lastName": "<string>",
        "userName": "<string>",
        "email": "<string>",
        "role": "SYS_ADMIN",
        "id": "<string>",
        "uid": "<string>"
      },
      "sourceLang": "<string>",
      "targetLangs": [
        "<string>"
      ],
      "references": [
        {
          "id": "<string>",
          "uid": "<string>",
          "filename": "<string>",
          "note": "<string>",
          "dateCreated": "2023-11-07T05:31:56Z",
          "createdBy": {
            "firstName": "<string>",
            "lastName": "<string>",
            "userName": "<string>",
            "email": "<string>",
            "role": "SYS_ADMIN",
            "id": "<string>",
            "uid": "<string>"
          }
        }
      ],
      "mtSettingsPerLanguageList": [
        {
          "targetLang": "<string>",
          "machineTranslateSettings": {
            "id": "<string>",
            "uid": "<string>",
            "name": "<string>",
            "type": "<string>"
          }
        }
      ],
      "userRole": "<string>"
    }
  ],
  "sort": {
    "orders": [
      {
        "direction": "ASC",
        "property": "<string>"
      }
    ]
  }
}

Guides

API Documentation

List projects

Query Parameters

Response