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

# Look up an on-chain builder

> Requires tokens scope and shares its quota. Reads verified canonical registry state, including suspended codes. Unknown code returns 404; uncommissioned registry returns 503. No local-database fallback.

Use your generated workspace builder ID as `code`. This reads the registered owner, payout wallet, default fee, fee cap and enabled status.

`routeFeeBps: null` means Route's standard fee schedule applies. An ID assigned in the portal can return `404` until registered onchain.

```bash theme={null}
curl 'https://api.route.fun/api/v2/builders/profile?code=YOUR_BUILDER_ID' \
  -H "x-api-key: $ROUTE_API_KEY"
```

[Authentication](/api-reference/authentication) · [Builder integration](/builders)


## OpenAPI

````yaml openapi.json GET /api/v2/builders/profile
openapi: 3.1.0
info:
  title: route
  version: 2.15.0
  description: >-
    Route compares swap paths offchain and executes swaps on Robinhood Chain.
    The API returns quotes and unsigned transactions. It does not sign or submit
    for you. V2 deducts a disclosed pair-dependent output fee up to 0.50%; pool
    fees, provider charges and gas may still apply. Contracts are experimental
    and unaudited. Public routing and data endpoints require no API key. Use the
    documented /api/v2 endpoints for integrations. Builder endpoints require a
    scoped x-api-key from build.route.fun. Public quote, swap and data endpoints
    remain keyless.
servers:
  - url: https://api.route.fun
security: []
paths:
  /api/v2/builders/profile:
    get:
      tags:
        - Builder API
      summary: Look up an on-chain builder
      description: >-
        Requires tokens scope and shares its quota. Reads verified canonical
        registry state, including suspended codes. Unknown code returns 404;
        uncommissioned registry returns 503. No local-database fallback.
      operationId: getBuilder
      parameters:
        - in: query
          name: code
          required: true
          schema:
            type: string
            pattern: ^[A-Za-z0-9_-]{3,32}$
      responses:
        '200':
          description: Verified registry or finalized history result
          content:
            application/json:
              schema:
                type: object
                properties:
                  builder:
                    type: object
                    properties:
                      code:
                        type: string
                        pattern: ^[A-Za-z0-9_-]{3,32}$
                      owner:
                        type: string
                        pattern: ^0x[0-9a-fA-F]{40}$
                      pendingOwner:
                        type: string
                        pattern: ^0x[0-9a-fA-F]{40}$
                      recipient:
                        type: string
                        pattern: ^0x[0-9a-fA-F]{40}$
                      builderFeeBps:
                        type: integer
                        minimum: 0
                        maximum: 50
                      maxBuilderFeeBps:
                        type: integer
                        minimum: 0
                        maximum: 50
                      routeFeeBps:
                        anyOf:
                          - type: integer
                            minimum: 0
                            maximum: 50
                          - type: 'null'
                      enabled:
                        type: boolean
                      version:
                        type: integer
                      policySource:
                        const: onchain
                        type: string
                      registry:
                        type: string
                        pattern: ^0x[0-9a-fA-F]{40}$
                      policyBlock:
                        type: string
                        pattern: ^[0-9]+$
                      policyBlockHash:
                        type: string
                        pattern: ^0x[0-9a-fA-F]{64}$
                    required:
                      - code
                      - owner
                      - pendingOwner
                      - recipient
                      - builderFeeBps
                      - maxBuilderFeeBps
                      - routeFeeBps
                      - enabled
                      - version
                      - policySource
                      - registry
                      - policyBlock
                      - policyBlockHash
                    additionalProperties: false
                required:
                  - builder
                additionalProperties: false
        '400':
          description: Malformed input, invalid code/cursor or fee above cap
        '401':
          description: Missing or invalid API key
        '403':
          description: Missing required API key scope
        '404':
          description: Builder not registered (lookup)
        '409':
          description: Registry operation rejected or history snapshot changed
        '429':
          description: Caller workspace or global rate limit
        '503':
          description: >-
            Registry/collector not commissioned, RPC unavailable, or
            verification/capacity failure
      security:
        - BuilderKey: []
components:
  securitySchemes:
    BuilderKey:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Server-side key created in an authenticated developer workspace. Builder
        codes are public attribution, not credentials.

````