Account API

GET /me

curl https://api.rebill.co.za/me \
  -H "Authorization: Bearer sk_your_secret_key"

Response (abridged):

{
  "id": "acc123",
  "country": "ZA",
  "default_currency": "ZAR",
  "business_name": "Acme Corp Pty Ltd",
  "business_email": "[email protected]",
  "business_phone": "+27821234567",
  "vat_number": "4123456789",
  "tax_label": "VAT",
  "tax_rate": 1500,
  "timezone": "Africa/Johannesburg",
  "invoice_template": "standard",
  "hide_quote_status": false,
  "hide_quote_validity": false,
  "next_invoice_number": 42,
  "next_quote_number": 7,
  "client_code_auto": true,
  "client_code_prefix": "C",
  "next_client_code_number": 118,
  "subscription_status": "active",
  "has_logo": true,
  "logo_version": 1757400000
}

The full object is described below. logo_version is only present on this endpoint: the unix second of the last logo upload, 0 without a logo.

Fields marked read only are returned by GET /me but ignored by PUT /account.

PUT /account

Replaces your account settings with the body you send. Read the account first, change the fields you need and send the result back: many fields are cleared or reset to false when they are missing from the request.

• Cleared when omitted: business_phone, business_website, business_address, vat_number, invoice_notes, quote_notes, invoice_bank_details, invoice_payment_terms, terms, custom_fields, email_messages, reminder_schedule.
• Reset to false when omitted: every boolean except multi_currency, marketing_emails and brand_colour_emails.
• Unchanged when omitted: everything else, including the tax settings, timezone, hours, template, colours, late fee values, the next numbers and the client code prefix.

curl -X PUT https://api.rebill.co.za/account \
  -H "Authorization: Bearer sk_your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "business_name": "Acme Corp Pty Ltd",
    "business_email": "[email protected]",
    "business_phone": "+27821234567",
    "vat_number": "4123456789",
    "invoice_notes": "Thank you for your business.",
    "hide_quote_status": true,
    "hide_quote_validity": false,
    "client_code_auto": true,
    "client_code_prefix": "C",
    "next_client_code_number": 118
  }'

Response (200 OK): the saved account in the same shape as GET /me.

Validation problems return 400 Bad Request with the field name and reason, for example a next_invoice_number lower than the current one, a timezone that is not a known IANA zone, or a client_code_prefix with other characters. Premium only settings on the free plan return 402 Payment Required.