# List workflows (/docs/api-reference/workflows/listWorkflows) > Your workflows, oldest first, one cursor page at a time. Use it to find a workflow id. Pass back `next_cursor` until it is `null`. > **Workflow builder.** Included from the Jump Starter plan. [See plans](https://omnidim.io/pricing). **GET** `/workflows` Your workflows, oldest first, one cursor page at a time. Use it to find a workflow id. Pass back `next_cursor` until it is `null`. ```yaml operationId: listWorkflows parameters: - in: query name: user_id required: false description: | Reseller keys only: the id of one of your direct client users. The call then acts as that client, on that client's agents, numbers, campaigns and balance. Calls, sessions and bulk campaigns spend that client's balance and concurrency. Omit it to act on your own account. An empty value, `0`, `false` or your own user id also means your own account. Any other value that is not a positive integer id is refused with `400 invalid_request`. A key that is not a reseller's gets `403` when it names someone else. A user who is not your direct client gets `404`. schema: type: integer description: | Reseller keys only: the id of one of your direct client users. The call then acts as that client, on that client's agents, numbers, campaigns and balance. Calls, sessions and bulk campaigns spend that client's balance and concurrency. Omit it to act on your own account. Send it as a JSON integer in the body. `null`, `0`, `false` or your own user id also means your own account. Any other value that is not a positive integer id is refused with `400 invalid_request`. A key that is not a reseller's gets `403` when it names someone else. A user who is not your direct client gets `404`. example: 1234 - in: query name: limit schema: type: integer default: 20 minimum: 1 maximum: 100 description: Rows per page. - in: query name: cursor schema: type: string description: >- The `next_cursor` from the previous page. Omit it on the first request. Pass it back unchanged. responses: '200': description: One page of workflows. content: application/json: schema: type: object properties: data: type: array items: type: object properties: id: type: integer name: type: string status: type: string enum: - draft - active - paused updated_at: type: string nullable: true description: ISO 8601 time of the last change. has_more: type: boolean next_cursor: type: string nullable: true '400': description: >- A bad parameter or body. `code` says which, such as `invalid_json`, `invalid_parameter`, `missing_fields` or `no_options`. content: application/json: schema: type: object description: | The v1 error envelope. Some errors add keys: `errors` (validation issues), `op_index` and `hint` (a refused op), `revision` (the current revision after a conflict). properties: error: type: string description: Machine-readable error code, such as `revision_conflict`. error_description: type: string description: Human-readable explanation. code: type: string description: Stable, specific reason. Present on 400 errors and auth errors. request_id: type: string description: >- Correlates this response with the server log. Also sent as the `X-Request-Id` header. errors: type: array description: On `validation_failed`, the issues that blocked the request. items: type: object description: One problem found in a draft. properties: code: type: string description: > Stable issue code. `not_found`: an id is not in this workspace, pick one with `listWorkflowFieldOptions`. `templated_ref`: an id field holds a `{{ }}` template; ids must be literal. Others include `missing_field`, `bad_option`, `bad_handle`, `unreachable`, `trigger_count`, `unknown_type`, `unknown_reference` and `malformed`. message: type: string node: type: string nullable: true description: Id of the node the issue is about, if any. field: type: string nullable: true description: Config field the issue is about, if any. hint: type: string nullable: true description: What to do to fix it. op_index: type: integer description: On `invalid_op`, the zero-based position of the op that failed. hint: type: string description: On `invalid_op`, what to do next. revision: type: string description: On `revision_conflict`, the current revision of the draft. example: error: invalid_request error_description: revision is required. Read the workflow to get it. code: missing_fields request_id: req_5d9a1f3e8b02 '401': description: Missing or invalid API key. content: application/json: schema: type: object description: | The v1 error envelope. Some errors add keys: `errors` (validation issues), `op_index` and `hint` (a refused op), `revision` (the current revision after a conflict). properties: error: type: string description: Machine-readable error code, such as `revision_conflict`. error_description: type: string description: Human-readable explanation. code: type: string description: Stable, specific reason. Present on 400 errors and auth errors. request_id: type: string description: >- Correlates this response with the server log. Also sent as the `X-Request-Id` header. errors: type: array description: On `validation_failed`, the issues that blocked the request. items: type: object description: One problem found in a draft. properties: code: type: string description: > Stable issue code. `not_found`: an id is not in this workspace, pick one with `listWorkflowFieldOptions`. `templated_ref`: an id field holds a `{{ }}` template; ids must be literal. Others include `missing_field`, `bad_option`, `bad_handle`, `unreachable`, `trigger_count`, `unknown_type`, `unknown_reference` and `malformed`. message: type: string node: type: string nullable: true description: Id of the node the issue is about, if any. field: type: string nullable: true description: Config field the issue is about, if any. hint: type: string nullable: true description: What to do to fix it. op_index: type: integer description: On `invalid_op`, the zero-based position of the op that failed. hint: type: string description: On `invalid_op`, what to do next. revision: type: string description: On `revision_conflict`, the current revision of the draft. example: error: unauthorized error_description: Missing or invalid API key code: invalid_api_key request_id: req_6e2b9d4f1a38 '403': description: | The Workflow Builder is not enabled for this account (`feature_not_enabled`), or your API key's user cannot make this change (`permission_denied`). The Workflow Builder must be included in your plan. content: application/json: schema: type: object description: | The v1 error envelope. Some errors add keys: `errors` (validation issues), `op_index` and `hint` (a refused op), `revision` (the current revision after a conflict). properties: error: type: string description: Machine-readable error code, such as `revision_conflict`. error_description: type: string description: Human-readable explanation. code: type: string description: Stable, specific reason. Present on 400 errors and auth errors. request_id: type: string description: >- Correlates this response with the server log. Also sent as the `X-Request-Id` header. errors: type: array description: On `validation_failed`, the issues that blocked the request. items: type: object description: One problem found in a draft. properties: code: type: string description: > Stable issue code. `not_found`: an id is not in this workspace, pick one with `listWorkflowFieldOptions`. `templated_ref`: an id field holds a `{{ }}` template; ids must be literal. Others include `missing_field`, `bad_option`, `bad_handle`, `unreachable`, `trigger_count`, `unknown_type`, `unknown_reference` and `malformed`. message: type: string node: type: string nullable: true description: Id of the node the issue is about, if any. field: type: string nullable: true description: Config field the issue is about, if any. hint: type: string nullable: true description: What to do to fix it. op_index: type: integer description: On `invalid_op`, the zero-based position of the op that failed. hint: type: string description: On `invalid_op`, what to do next. revision: type: string description: On `revision_conflict`, the current revision of the draft. example: error: forbidden error_description: You do not have permission to use Workflows. code: feature_not_enabled request_id: req_9f2c1a4b7d3e ``` **curl** ```bash curl -X GET "https://backend.omnidim.io/api/v1/workflows?user_id=1234" \ -H "Authorization: Bearer $OMNIDIM_API_KEY" ```