Skip to main content
GET
/
v1
/
workflows
List workflows (Beta)
curl --request GET \
  --url https://api.valyu.ai/v1/workflows \
  --header 'X-API-Key: <api-key>'
{
  "workflows": [
    {
      "slug": "ib-company-profile",
      "version": 1,
      "title": "Company Profile",
      "vertical": "investment-banking",
      "tags": [
        "company-profile",
        "equities"
      ],
      "subtitle": "One-page profile of a public company.",
      "description": "Builds a company profile covering business, financials, and recent developments.",
      "popular": true,
      "recommended_mode": "heavy",
      "estimated_time": "10-20 min",
      "is_valyu": true,
      "owner_org_id": null,
      "variables": [
        {
          "key": "company",
          "label": "Company name",
          "type": "text",
          "required": false,
          "placeholder": "NVIDIA (NVDA)",
          "help": "The company you want to profile.",
          "examples": [
            "NVIDIA (NVDA)",
            "Microsoft (MSFT)"
          ],
          "validation": {
            "min_length": 1,
            "max_length": 2,
            "pattern": "<string>",
            "enum": [
              "<string>"
            ]
          }
        }
      ],
      "deliverables": [
        {
          "type": "xlsx",
          "description": "A model summary tab with revenue, margins, and key ratios."
        }
      ],
      "created_at": "2026-01-10T12:00:00Z",
      "updated_at": "2026-01-15T09:30:00Z",
      "prompt": "Build a company profile for {company} covering its business, financials, and recent developments.",
      "strategy": "<string>",
      "report_format": "<string>",
      "tools": {
        "code_execution": true,
        "screenshots": true,
        "browser_use": true,
        "charts": true
      },
      "changelog": "<string>",
      "output_formats": [
        {
          "type": "object",
          "properties": {
            "base_case": {
              "type": "string"
            },
            "bull_case": {
              "type": "string"
            },
            "bear_case": {
              "type": "string"
            },
            "confidence": {
              "type": "number"
            }
          }
        },
        "toon"
      ]
    }
  ],
  "total": 44,
  "next_cursor": null,
  "verticals": [
    "consulting",
    "private-equity",
    "life-sciences",
    "investment-banking",
    "hedge-funds",
    "legal-regulatory",
    "sales-intelligence",
    "supply-chain"
  ]
}

Authorizations

X-API-Key
string
header
required

API key for authentication. Get yours at platform.valyu.ai.

Query Parameters

vertical
string

Filter by vertical (e.g. finance, life-sciences).

scope
enum<string>
default:all

Which workflows to return: valyu (curated only), org (your org only), or all (both, default).

Available options:
valyu,
org,
all
q
string

Free-text search across title, subtitle, and description.

tags
string

Comma-separated tags to filter by.

limit
integer
default:50

Maximum number of workflows to return (max 100).

Required range: 1 <= x <= 100
expand
string

Comma-separated list of fields to expand. Pass version to include the full current version row for each workflow.

Response

List of workflows.

List of workflows.

workflows
object[]
required
total
integer
required

Total number of workflows matching the filter.

Example:

44

next_cursor
string | null

Pagination cursor for the next page, or null when there are no more results.

Example:

null

verticals
string[]

Distinct verticals present across the curated catalog.

Example:
[
"consulting",
"private-equity",
"life-sciences",
"investment-banking",
"hedge-funds",
"legal-regulatory",
"sales-intelligence",
"supply-chain"
]