> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blnkfinance.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get instruction

> Retrieve a single watch instruction by its numeric ID.

<Note>Blnk Watch is currently in beta. [Send us a message](mailto:support@blnkfinance.com)</Note>

Use this endpoint to fetch one instruction by ID. The response includes the original DSL script and the compiled rule JSON.

### Path

<ParamField path="id" type="integer" required>
  The numeric instruction ID.
</ParamField>

<RequestExample>
  ```bash theme={"system"}
  curl http://localhost:8081/instructions/1
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"system"}
  {
    "id": 1,
    "name": "HighValueTransaction",
    "text": "rule HighValueTransaction {\n    description \"Review any transaction above $10,000\"\n    when amount > 10000\n    then review\n         score   0.5\n         reason  \"Amount exceeds threshold\"\n}",
    "description": "Review any transaction above $10,000",
    "dsl_json": "{\"name\":\"HighValueTransaction\",\"when\":[...],\"then\":{...}}",
    "created_at": "2026-03-16T10:00:00Z",
    "updated_at": "2026-03-16T10:00:00Z"
  }
  ```

  ```text 400 theme={"system"}
  Invalid instruction ID: abc
  ```

  ```text 404 theme={"system"}
  instruction with ID 99 not found
  ```

  ```text 500 theme={"system"}
  Failed to retrieve instruction
  ```
</ResponseExample>

### Response fields

<ResponseField name="id" type="integer">
  Auto-generated instruction ID.
</ResponseField>

<ResponseField name="name" type="string">
  Unique rule name.
</ResponseField>

<ResponseField name="text" type="string">
  Original Watch DSL script text.
</ResponseField>

<ResponseField name="description" type="string">
  Rule description from the DSL script, if provided.
</ResponseField>

<ResponseField name="dsl_json" type="string">
  Compiled rule JSON used during transaction evaluation.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp of when the instruction was created.
</ResponseField>

<ResponseField name="updated_at" type="string">
  ISO 8601 timestamp of when the instruction was last updated.
</ResponseField>

***

## Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool.

To ask questions or discuss issues, please [contact us](mailto:support@blnkfinance.com) or [join our Discord community](https://discord.gg/7WNv94zPpx).

**Connect your ledger to Blnk Cloud**

Sign up and manage your ledger with our back-office dashboard. You can invite teammates to collaborate and manage your ledger operations directly from the dashboard.