Business API

Use the Business API to retrieve and update the workspace associated with the authenticated API key.

Business object

Field	Type	Description
id	string	Business ID with the biz_ prefix.
name	string	Business name.
email	string	Primary business email.
phone	string | null	Primary phone number.
currency	string	ISO 4217 currency code.
country	string	ISO 3166-1 alpha-2 code.
timezone	string	IANA timezone identifier.
created_at	string	ISO 8601 creation timestamp.
updated_at	string	ISO 8601 last-update timestamp.

Retrieve the business

GET /business

curl https://api.cedius.app/v1/business   -H "Authorization: Bearer cedius_test_sk_example"

200 OK

{
  "data": {
    "id": "biz_8f3a91",
    "name": "Master Frosty Foods",
    "email": "hello@masterfrosty.ng",
    "phone": "+2348012345678",
    "currency": "NGN",
    "country": "NG",
    "timezone": "Africa/Lagos",
    "created_at": "2026-09-01T09:00:00Z",
    "updated_at": "2026-09-09T10:00:00Z"
  }
}

Update the business

PATCH /business

Editable fields: name, email, phone, currency, country, timezone.

curl -X PATCH https://api.cedius.app/v1/business   -H "Authorization: Bearer cedius_test_sk_example"   -H "Content-Type: application/json"   -d '{
    "name": "Master Frosty Foods Ltd",
    "timezone": "Africa/Lagos"
  }'

Common errors

Status	Code	Meaning
401	authentication_failed	API key is missing or invalid.
403	permission_denied	Caller cannot update settings.
422	validation_error	Submitted values are invalid.