Batchrouter Docs

The provider portal

A tour of the Batchrouter provider portal - its tabs, roles and sharing, lanes, capacity windows, jobs, earnings and statements, payout details, and archiving or deleting a provider.

The provider portal is where you run your provider: the setup checklist, your models and lanes, the work Batchrouter sends you, and what you earn. This page walks through it tab by tab. The setup steps themselves are in the onboarding checklist.

Until you go live, the setup checklist sits above the tabs. Each open step has a button that takes you to the fix: Add model, Run connection test, the Offerings tab for prices and capacity, and so on.

Until you verify your email address, the whole portal is read-only. You can look around, but adding models, testing the endpoint, going live, and editing prices, capacity and payout details unlock once you confirm.

The tabs

TabWhat it's for
OverviewYour provider profile, live telemetry, endpoint health, data handling and commercial terms. The owner also gets the danger zone here
OperationsLaunch readiness, routing controls, coverage, live lanes, job health and capacity windows
OfferingsYour models and the offering lanes they serve: prices, SLA tiers, data handling and capacity
JobsThe most recent work Batchrouter assigned to you
EarningsWhat you're owed, by payout status, your payout statements and the latest ledger lines
PayoutsWhere Batchrouter sends your earnings
AccessYour role, and the accounts your provider is shared with

Overview

The Provider profile card shows your slug, provider type, integration, contact, endpoint, throughput and reliability. Edit profile opens the profile in four parts: Profile, Integration (your base URL and the API key Batchrouter calls you with), Logo and Operations. Changing the base URL or the key resets the endpoint test, so run it again.

Below it, Live telemetry shows assigned and completed work, throttle rate, average latency, and reserved and available capacity, with the result of the last endpoint check. Further down are your data-handling declarations (data collection, zero data retention, training use), your provider rate limits and your commercial terms.

Operations

The top row says whether you're ready to launch, how many lanes can take work, your declared capacity and any job issues. Below it:

  • Routing controls: live lanes, active capacity windows, lanes that need a heartbeat and your declared capacity, with Add window for a capacity window.
  • Coverage and metadata: the operations, privacy tiers, model families and runtime profiles your lanes declare.
  • Live offering lanes: quick controls per lane (see Lanes).
  • Job health signals: assigned, running, completed and rejected work, average latency, and the jobs that need attention.
  • Capacity windows: your recent and upcoming windows.

Offerings

Model offerings lists your models and the lanes they serve. Add model adds a model and creates its first lane; Add lane adds another lane. See Lanes.

Coming: editing a model after you add it (its names, Hugging Face repo, quantization, context window, operations, privacy tiers and per-model prices) and retiring a model.

Roles and sharing

An account owns one provider. To work on a provider someone else owns, its owner shares it with your account. A provider can be shared with any number of accounts, and an account can be shared into any number of providers.

Each account with access has one role:

RoleWhat it can do
OwnerEverything an admin can do, plus sharing, payout details, the Provider Agreement and archiving
AdminRuns the provider: models, lanes, prices, capacity, jobs, the endpoint and profile, and sees earnings. Can't share the provider, change payout details, accept the agreement or archive it
BillingSees everything, including earnings and payout statements. Makes no changes
ViewerSees the portal without earnings or payout statements. Makes no changes

The Access tab shows your own role and when it was granted. Under Shared accounts, the owner and admins see every account with access and its role; billing and viewer accounts see a note instead.

To share, the owner presses Share provider, enters the email the other account signs in with (or its account ID, org_…, if that account hasn't verified its email yet), and picks admin, billing or viewer. The owner can revoke any shared account. The owner row can't be revoked.

Lanes

A lane is one way you serve a model: its integration, prices, SLA tiers, data handling and capacity. Add model creates a model's first lane; Edit on a lane changes it.

  • Prices. Your batch and direct prices, in USD per 1 million tokens. A change reaches new work only, and the portal shows a notice when you save one. See Changing your prices.
  • SLA tiers. The customer tiers the lane takes work for: Priority, Standard, Relaxed, Flex and Economy. Each shows the customer's window and yours, for example Standard is 24 hours for the customer and 10 hours for you. Pick at least one. You can give each tier its own price; a tier left blank runs at the lane's batch price, and prices must fall from your direct price through Priority, Standard, Relaxed and Flex to Economy. Leaving a tier takes effect after 24 hours' notice, and the lane shows until when it still works that tier. Customers can buy Standard today; the other tiers open when they launch. See SLA tiers.
  • Data handling. Retention, training and countries, each "same as your provider profile" unless the lane declares its own: zero data retention or a number of days, whether the lane trains on customer data (off by default), and the countries the lane runs inference in. See Per-lane data handling.
  • Declared capacity. The batch sizes, concurrent batches and items the lane will accept. See Publish capacity.

Each lane in Live offering lanes has quick controls:

  • Pause stops new work to the lane. Resume asks you to confirm, then makes the lane active again. No payment is owed for the time a lane was inactive.
  • Send heartbeat appears on lanes whose capacity expires on a heartbeat. It refreshes the lane's capacity; it never resumes a paused lane. See Capacity and heartbeats.

Coming: each lane's version history (when each version took effect), and Retire lane.

Capacity windows

A capacity window commits capacity for a period: when it starts and ends, the maximum and remaining work units, the lane kind (standard, spot, discount or SLA), a spot discount, and the regions it allows or excludes. Add window on the Operations tab creates one, and the Capacity windows card shows your recent and upcoming windows with what is remaining and reserved.

Coming: commitment tiers per window (long-term and spot), pausing, resuming and expiring a window, and scheduling a change to a window (its work units, price or status) from a date you pick.

Jobs

The Jobs tab lists the most recent work Batchrouter assigned to you: status, operation, model family, items, attempts, deadline and when it last changed.

Coming: opening a job to see its items, executions, status history and errors, and filtering the list by status.

Earnings and statements

The Earnings tab is for the owner, admins and billing accounts. A viewer sees a note that its role can't see earnings.

  • Provider payable, Current month and Statements at the top.
  • Payout status: what you're owed, grouped by settlement status.
  • Payout statements: one per monthly payout, with its period, status, lines, net payable and payment status. Download each as CSV, JSON or PDF.
  • Recent ledger: the 10 latest settlement ledger lines.

How the monthly cycle works is in Earnings and payouts.

Coming: a full ledger you can filter by status and period, and a status filter on statements.

Payout details

The Payouts tab shows the bank account on file (masked, for example the last 4 digits), how payouts are sent and the remittance email. Only the owner can add, change or remove payout details; everyone else sees the state and who can change it. What to enter is in Add your bank details.

Archive, reactivate and delete

The owner finds these in the Danger zone at the bottom of the Overview tab.

  • Archive provider removes your provider from public listings and stops all routing at once. You confirm by typing your provider's slug. Archiving frees your account to own another provider.
  • Reactivate provider sets an archived provider back to setup. Finish any open checklist steps and press Go live; routing resumes as soon as you're live.
  • Request permanent deletion sends a request, with an optional reason, to Batchrouter's operators. Once they action it, everything is removed for good: models, offerings, settlement history and team access. It can't be undone.

Need help?

Email hello@batchrouter.com with your provider name. Never include API keys or bank details in email.

On this page