---
title: "Workflow steps this month, by workflow"
description: "Workflow steps of the current UTC month against the plan, by workflow."
canonical: "https://grid82.com/docs/builder-api/billing/workflows"
updated: "2026-11-20"
---

# Workflow steps this month, by workflow

`GET https://studio.grid82.app/v1/organizations/{organizationId}/billing/workflows`

Workflow steps of the current UTC month against the plan, by workflow.

One step is one action a run executes: each pass of a loop counts; the trigger, a branch not taken, a retry after a failure and a test from the editor do not. At the limit no new run starts until the 1st; runs already going finish.

Requires the `account:read` scope. Operation `billing.workflows`. MCP tool `billing_workflows`. CLI: `grid82 billing workflows` (`npx @grid82/cli`).

## Path parameters

| Name             | Type   | Required | Description |
| ---------------- | ------ | -------- | ----------- |
| `organizationId` | string | yes      |             |

**Authorizations**

- `Authorization` (bearer, in header, required)

## Response

**200**: Success

- `data` (`object`, required)
- `data.month` (`string`, required)
- `data.resetsOn` (`string`, required)
- `data.steps` (`integer`, required)
- `data.limit` (`integer | null`, required)
- `data.standing` (`enum<string>`, required, one of: `ok, near, reached`)
- `data.stepsToday` (`integer`, required)
- `data.testsToday` (`integer`, required)
- `data.testsPerDay` (`integer`, required)
- `data.stepsPerRun` (`integer`, required)
- `data.workflows` (`object[]`, required)
- `data.workflows.appId` (`string`, required)
- `data.workflows.appName` (`string,null`, required)
- `data.workflows.workflowId` (`string`, required)
- `data.workflows.name` (`string,null`, required)
- `data.workflows.steps` (`integer`, required)
- `data.workflows.runs` (`integer`, required)
- `data.workflows.stepsPerRun` (`number,null`, required)

```json
{
  "data": {
    "month": "<string>",
    "resetsOn": "<string>",
    "steps": 123,
    "limit": 123,
    "standing": "ok",
    "stepsToday": 123,
    "testsToday": 123,
    "testsPerDay": 123,
    "stepsPerRun": 123,
    "workflows": [
      {
        "appId": "<string>",
        "appName": null,
        "workflowId": "<string>",
        "name": null,
        "steps": 123,
        "runs": 123,
        "stepsPerRun": null
      }
    ]
  }
}
```

**4XX**: Refused

- `error` (`object`, required)
- `error.code` (`enum<string>`, required, one of: `not_found, forbidden, unauthenticated, validation_failed, conflict, rate_limited, payment_required, not_implemented, internal`)
- `error.message` (`string`, required)
- `error.details` (`Record<string, unknown>`)

```json
{
  "error": {
    "code": "not_found",
    "message": "<string>",
    "details": {}
  }
}
```

**Example request**

```bash
curl --request GET \
  --url 'https://studio.grid82.app/v1/organizations/<organizationId>/billing/workflows' \
  --header 'Authorization: Bearer <token>'
```
