Skip to main content
GET
/
business-units
/
{id}
Get a business unit
curl --request GET \
  --url https://www.ruddr.io/api/workspace/business-units/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "c5a1e7d3-8f42-4b96-a0d8-f3b7c6e02d19",
  "name": "Central Division",
  "isActive": true,
  "companyName": "Acme Corp - Central",
  "streetAddress": "789 Wacker Dr\nChicago, IL 60601",
  "invoiceSubject": "Invoice for services rendered - Central",
  "invoiceNotes": "Please remit payment within terms.",
  "invoiceEmailSubject": "Your invoice from Acme Corp - Central",
  "invoiceEmailBody": "Attached is your invoice. Thank you for your continued partnership.",
  "invoiceEmailFromName": "Acme Central Billing",
  "invoiceEmailReplyTo": "billing-central@acmecorp.com",
  "invoiceTaxableItems": [
    "services",
    "expenses",
    "other_items"
  ],
  "createdAt": "2025-09-12T16:42:18.293Z",
  "invoicePaymentTerm": {
    "id": "f2d8a5c1-4e37-4b90-81d6-e3b7c6f02a19",
    "name": "Net 45",
    "type": "net",
    "days": 45
  },
  "invoiceTaxRate": {
    "id": "a7e3b1d9-5c28-4f84-92d0-f1b7c6e03a48",
    "name": "Regional Tax",
    "rate": 6.25
  }
}
A named organizational unit used to configure invoice settings and group clients and projects.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

The business unit uuid.

Response

200

id
string

The unique identifier for the object.

name
string

The name of the business unit.

isActive
boolean

Whether the business unit is active.

companyName
string | null

The company name displayed on invoices for this business unit.

streetAddress
string | null

The street address displayed on invoices for this business unit.

invoiceSubject
string | null

The default subject line for invoices.

invoiceNotes
string | null

The default notes for invoices.

invoiceEmailSubject
string | null

The default email subject when sending invoices.

invoiceEmailBody
string | null

The default email body when sending invoices.

invoiceEmailFromName
string | null

The sender name used when emailing invoices.

invoiceEmailReplyTo
string | null

The reply-to email address used when emailing invoices.

invoiceTaxableItems
enum<string>[]

The types of invoice line items that are taxable.

Available options:
services,
expenses,
other_items
createdAt
string<date-time>

The timestamp when the object was created.

invoicePaymentTerm
object

The default payment term for invoices.

invoiceTaxRate
object

The default tax rate for invoices.