Get Workflow Runs - Saras Finance

curl --location 'https://api.sarasfinance.com/v1/process/getWorkflowRuns?subProjectId=93d599a6-a396-4ef6-b30e-aff95c56c523&processId=ef341826-1cab-4680-aa52-efd001f9da00' \
--header 'Authorization: Bearer <token>'

{
  "runs": [
    {
      "id": "run_017b2c9a",
      "workflowId": "wf_b2a7590d",
      "processId": "ef341826-1cab-4680-aa52-efd001f9da00",
      "state": "COMPLETED",
      "createdTs": "2026-04-16T12:00:00Z"
    }
  ]
}

GET

process

getWorkflowRuns

curl --location 'https://api.sarasfinance.com/v1/process/getWorkflowRuns?subProjectId=93d599a6-a396-4ef6-b30e-aff95c56c523&processId=ef341826-1cab-4680-aa52-efd001f9da00' \
--header 'Authorization: Bearer <token>'

{
  "runs": [
    {
      "id": "run_017b2c9a",
      "workflowId": "wf_b2a7590d",
      "processId": "ef341826-1cab-4680-aa52-efd001f9da00",
      "state": "COMPLETED",
      "createdTs": "2026-04-16T12:00:00Z"
    }
  ]
}

Query Parameters

string

required

The unique identifier for the sub-project.

string

Filter runs by stage key.

string

Filter runs by process ID.

string

Filter runs by workflow ID.

string

Retrieve a specific workflow run by ID.

Response

object[]

Show properties

string

The unique identifier for the run.

string

The associated workflow ID.

string

The associated process ID.

string

The status of the execution (e.g. COMPLETED, PAUSED, FAILED, RACING).

string

ISO timestamp of run initialization.

curl --location 'https://api.sarasfinance.com/v1/process/getWorkflowRuns?subProjectId=93d599a6-a396-4ef6-b30e-aff95c56c523&processId=ef341826-1cab-4680-aa52-efd001f9da00' \
--header 'Authorization: Bearer <token>'

{
  "runs": [
    {
      "id": "run_017b2c9a",
      "workflowId": "wf_b2a7590d",
      "processId": "ef341826-1cab-4680-aa52-efd001f9da00",
      "state": "COMPLETED",
      "createdTs": "2026-04-16T12:00:00Z"
    }
  ]
}

Error Codes

Code	ID	Description
`ERROR_PROCESS_META_IS_MISSING_IN_REQUEST`	1200	Metadata missing in request
`ERROR_SUBPROCESS_META_NOT_FOUND`	1202	Sub-project metadata not found
`ERROR_NOT_ALLOWED_TO_GET`	1205	User unauthorized to view data

​Query Parameters

​Response

​Error Codes

Query Parameters

Response

Error Codes