---
title: "View a routine"
locale: en
url: https://tlg.builera.app/en/docs/reference/rest/routines.get
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# View a routine

One routine with its current revision and the latest runs (per account and slot, with the sequence status).

One routine with its current revision and the latest runs (per account and slot, with the sequence status).

## Overview

| Name | Value |
| --- | --- |
| Code | `routines.get` |
| Scope needed | `accounts.read` |
| Risk | Read |
| May need confirmation | No |
| Runs as | Answers right away |
| Needs `Idempotency-Key` | No |
| Member roles allowed | `owner`, `manager`, `viewer` |
| In the app | Automation → Routines → open a routine |

## Input fields

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `uuid` | Yes |   |

## Example request

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/routines.get \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"00000000-0000-0000-0000-000000000000"}'
```

## Output fields (`data`)

| Field | Type | Required |
| --- | --- | --- |
| `routine` | `object` | Yes |
| `revision` | `number` | Yes |
| `runs` | `object[]` | Yes |

## Example answer

```json
{
  "data": {
    "routine": {
      "id": "00000000-0000-4000-8000-000000000000",
      "name": "text",
      "enabled": true,
      "schedule": {
        "kind": "weekly",
        "times": [
          "text"
        ],
        "days": [
          1
        ]
      },
      "target": {
        "accountIds": [
          "text"
        ],
        "tags": [
          "text"
        ]
      },
      "steps": "text",
      "lastRunAt": "2026-10-22T12:00:00.000Z",
      "nextRunAt": "2026-10-22T12:00:00.000Z"
    },
    "revision": 1,
    "runs": [
      {
        "sequence_status": "text",
        "id": "00000000-0000-4000-8000-000000000000",
        "account_id": "00000000-0000-4000-8000-000000000000",
        "slot": "text",
        "sequence_id": "00000000-0000-4000-8000-000000000000",
        "status": "text",
        "detail": "text",
        "created_at": "2026-10-22T12:00:00.000Z"
      }
    ]
  }
}
```

## Using it over MCP

Not listed on any profile: call `tools_describe` then `tools_run` with `code: "routines.get"`. Tool name when listed: `routines_get`.