---
title: "Retrieve a number of previously run processes"
method: GET
path: "/v1/org/{orgId}/process"
tags: ["process"]
---

# Retrieve a number of previously run processes

`GET /v1/org/{orgId}/process`

## Path parameters

- `orgId` string, required

## Query parameters

- `isAppProcess` boolean
- `appId` string
- `parentProcessId` string
- `type` string
- `createAtFrom` string
- `createAtUntil` string
- `statuses` string
- `isParentProcess` boolean
- `processTypes` string
- `searchValue` string
- `from` string
- `limit` integer
- `syncDirections` string
- `syncCauses` string
- `runUserId` string

## Response `200`

successful operation

- ResultsProcess
  - `data` Process[], required
    - `id` string, required — globally unique id
    - `orgId` string, required — parent org id
    - `label` string, required — human-readable label that identifies this process
    - `type` string, required — process type
    - `status` 'PENDING' | 'RUNNING' | 'DONE' | 'ERROR', required — current status of process
    - `filePath` string — data file path
    - `logPath` string — data log path
    - `runUserId` string, required — user id who is running the process
    - `parentProcessId` string — process id of parent process
    - `createId` string, required — created by user id (user who requested the process run)
    - `createBehalfId` string — created on behalf of user id
    - `createAttribution` Attribution
      - `principalUserId` string
      - `agentUserIds` string[]
      - `eventId` string
      - `aiChatId` string
      - `aiToolUseId` string
      - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
    - `createAt` string, required — created timestamp
    - `updateId` string — last updated by user id
    - `updateBehalfId` string — last updated on behalf of user id
    - `updateAttribution` Attribution
      - `principalUserId` string
      - `agentUserIds` string[]
      - `eventId` string
      - `aiChatId` string
      - `aiToolUseId` string
      - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
    - `updateAt` string — last updated timestamp
    - `startAt` string — started at timestamp
    - `endAt` string — ended at timestamp
    - `message` string — status or error message
    - `progress` number, double — percent progress so far
    - `internalError` string — internal-only error message
    - `options` object, required — options passed to the process
    - `results` object — results summary for the process
    - `logDataList` LogData[] — list of log data that occurred during running of this process
      - `level` 'INFO' | 'WARN' | 'ERROR', required
      - `at` string, required — created timestamp
      - `message` string
      - `data` object, required
    - `state` object — process-specific state data
    - `summary` string — human-readable, searchable summary of what this process did
    - `appId` string — app id of the process
    - `uuid` string — unique ID of the process at queue time
  - `next` string
  - `access` ResultsAccess[]
    - `ids` string[]
    - `allowed` AccessAction[], required
      - `action` string, required
      - `fields` string[]
      - `types` string[]

## Other responses

- `400` — invalid data
- `401` — not authorized
- `403` — permission denied

---

[API](https://skmtc.net/charthop/apis/charthop-api.md) · [All operations](https://skmtc.net/charthop/apis/charthop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/charthop/charthop-api/versions/50a1edd6b27e/schema)