---
title: "Get builder"
method: GET
path: "/v1/builders/{slug}"
tags: ["Orders"]
---

# Get builder

`GET /v1/builders/{slug}`

Returns builder info and, if account is provided, the user's current approved max fee for that builder.

## Path parameters

- `slug` string, required

## Query parameters

- `account` string

## Response `200`

A successful response.

- ApiGetBuilderResponse
  - `builder` ApiBuilderInfo — BuilderInfo holds display info for a registered builder.
    - `builder_id` integer
    - `slug` string
    - `name` string
    - `fee_recipient` string
    - `is_active` boolean — Whether the builder is currently active. Approving fees for an inactive builder is rejected on-chain (BuilderNotActive); FE should surface this before that point.
  - `user_max_fee_bps` integer — User's current approved max fee for this builder (parts per million, denom 1e6). Meaningless (0) unless has_approval is true — 0 is itself a valid explicit approval (revoked, or approved with a zero ceiling), indistinguishable from "never approved" without checking has_approval.
  - `has_approval` boolean — True if account was provided and has an on-record approval for this builder (even if that approval's max_fee_bps is 0). False if account was omitted or has never approved.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/rise/apis/risex-rest-api.md) · [All operations](https://skmtc.net/rise/apis/risex-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rise/risex-rest-api/revisions/194af8339c0d/schema)