---
updatedAt: 2026-06-15T14:45:23.000Z
agentTools:
  projectIndex: https://developers.lokalise.com/llms.txt
---

# List all processes

Retrieves a list of [Queued process](#object-queued-processes) objects.

Requires <code>read_background_processes</code> OAuth access scope.

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Default projects",
    "version": "1.0.0",
    "description": "Describes the API for default projects.\\n\\n**Project Type Compatibility**: Many API endpoints have different compatibility with project types:\\n- **Software projects** (localization_files) - Support individual key management, no file deletion\\n- **Documents projects** (paged_documents) - Support file management, no individual key operations\\n- **Marketing projects** (content_integration, marketing, marketing_integrations) - Mixed support depending on specific type\\n\\nBranching is only supported for Software projects. See individual endpoint documentation for specific compatibility information."
  },
  "servers": [
    {
      "url": "https://api.lokalise.com/api2"
    }
  ],
  "paths": {
    "/projects/{project_id}/processes": {
      "get": {
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "X-Pagination-Total-Count": {
                "schema": {
                  "type": "string"
                }
              },
              "X-Pagination-Page-Count": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "example": {
                  "project_id": "767946315e9866d013c1d0.08299127",
                  "processes": [
                    {
                      "process_id": "2e0559e60e856555fbc15bdf78ab2b0ca3406e8f",
                      "type": "file-import",
                      "status": "finished",
                      "message": "",
                      "created_by": 1234,
                      "created_by_email": "example@example.com",
                      "created_at": "2020-04-20 13:43:43 (Etc/UTC)",
                      "created_at_timestamp": 1587390223
                    },
                    {
                      "process_id": "f70bbf40059386a568d42c0f80297477e252cc48",
                      "type": "file-import",
                      "status": "finished",
                      "message": "",
                      "created_by": 1234,
                      "created_by_email": "example@example.com",
                      "created_at": "2020-04-20 13:48:00 (Etc/UTC)",
                      "created_at_timestamp": 1587390480
                    }
                  ]
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "project_id": {
                      "type": "string"
                    },
                    "processes": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/QueuedProcesses"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "summary": "List all processes",
        "operationId": "List all processes",
        "description": "Retrieves a list of [Queued process](#object-queued-processes) objects.\n\nRequires <code>read_background_processes</code> OAuth access scope.",
        "tags": [
          "Queued Processes"
        ],
        "parameters": [
          {
            "name": "project_id",
            "in": "path",
            "description": "A unique project identifier",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Number of items to include (max 5000).",
            "required": false,
            "example": "100",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Return results starting from this page.",
            "required": false,
            "example": "1",
            "schema": {
              "type": "integer"
            }
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "QueuedProcesses": {
        "type": "object",
        "properties": {
          "process_id": {
            "type": "string",
            "description": "A unique process identifier."
          },
          "type": {
            "type": "string",
            "description": "The type of the process. Can be <code>file-import</code>, <code>sketch-import</code> or <code>bulk-apply-tm</code>."
          },
          "status": {
            "type": "string",
            "description": "Current status of the process. Can be <code>queued</code>, <code>pre_processing</code>, <code>running</code>, <code>post_processing</code>, <code>cancelled</code>, <code>finished</code> or <code>failed</code>."
          },
          "message": {
            "type": "string",
            "description": "Can contain a message related to the current process status (such as an error message)."
          },
          "created_by": {
            "type": "number",
            "description": "ID of a user who initiated the process."
          },
          "created_by_email": {
            "type": "string",
            "description": "email of a user who initiated the process."
          },
          "created_at": {
            "type": "string",
            "description": "Date of when the process was created in the queue."
          },
          "created_at_timestamp": {
            "type": "number",
            "description": "Unix timestamp of when the process was created in the queue."
          }
        }
      }
    },
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Api-Token"
      }
    }
  },
  "security": [
    {
      "ApiKeyAuth": []
    }
  ]
}
```