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

# Organizations

> Understanding Organizations: The top-level container for your resources in Bluerails.

export const OrganizationStructureDiagram = () => {
  const UsersIcon = () => <svg width="18" height="18" viewBox="0 0 24 24" strokeWidth="1.5" stroke="currentColor" fill="none" strokeLinecap="round" strokeLinejoin="round" className="flex-shrink-0 mr-2 text-gray-500 dark:text-slate-400">
      <path stroke="none" d="M0 0h24v24H0z" fill="none" /> <path d="M12 4.354a4 4 0 110 5.292M15 21H3v-1a6 6 0 0112 0v1zm0 0h6v-1a6 6 0 00-9-5.197M13 7a4 4 0 11-8 0 4 4 0 018 0z" />
    </svg>;
  const OrgIcon = () => <svg width="18" height="18" viewBox="0 0 24 24" strokeWidth="1.5" stroke="currentColor" fill="none" strokeLinecap="round" strokeLinejoin="round" className="flex-shrink-0 mr-2 text-blue-600 dark:text-blue-300">
      <path stroke="none" d="M0 0h24v24H0z" fill="none" /> <path d="M19.5 14.25v-2.625a3.375 3.375 0 0 0-3.375-3.375h-1.5A1.125 1.125 0 0 1 13.5 7.125v-1.5a3.375 3.375 0 0 0-3.375-3.375H8.25m0 12.75h7.5m-7.5 3H12M10.5 2.25H5.625c-.621 0-1.125.504-1.125 1.125v17.25c0 .621.504 1.125 1.125 1.125h12.75c.621 0 1.125-.504 1.125-1.125V11.25a9 9 0 0 0-9-9Z" />
    </svg>;
  const AccountIcon = () => <svg width="18" height="18" viewBox="0 0 24 24" strokeWidth="1.5" stroke="currentColor" fill="none" strokeLinecap="round" strokeLinejoin="round" className="flex-shrink-0 mr-2 text-gray-500 dark:text-slate-400">
      <path stroke="none" d="M0 0h24v24H0z" fill="none" /> <path d="M2.25 8.25h19.5M2.25 9h19.5m-16.5 5.25h6m-6 2.25h3m-3.75 3h15a2.25 2.25 0 0 0 2.25-2.25V6.75A2.25 2.25 0 0 0 19.5 4.5h-15a2.25 2.25 0 0 0-2.25 2.25v10.5A2.25 2.25 0 0 0 4.5 21.75Z" />
    </svg>;
  const ArrowDownIcon = () => <svg width="24" height="24" viewBox="0 0 24 24" strokeWidth="1.5" stroke="currentColor" fill="none" strokeLinecap="round" strokeLinejoin="round" className="flex-shrink-0 text-slate-400 dark:text-slate-500">
      <path stroke="none" d="M0 0h24v24H0z" fill="none" />
      <path d="M12 5l0 14" />
      <path d="M18 13l-6 6" />
      <path d="M6 13l6 6" />
    </svg>;
  return <div className="my-8 flex flex-col items-center justify-center gap-4 p-4">

      <div className="w-full max-w-md text-center mb-1">
        <span className="text-xs font-semibold uppercase text-gray-500 dark:text-slate-400 tracking-wider">Users</span>
      </div>
      <div className="flex flex-wrap justify-center gap-3">
        <div className="flex items-center p-2 px-4 border border-gray-200 dark:border-slate-700 bg-white dark:bg-slate-800 rounded-full shadow-sm">
          <UsersIcon />
          <span className="text-sm text-gray-700 dark:text-slate-200">User 1</span>
        </div>
        <div className="flex items-center p-2 px-4 border border-gray-200 dark:border-slate-700 bg-white dark:bg-slate-800 rounded-full shadow-sm">
          <UsersIcon />
          <span className="text-sm text-gray-700 dark:text-slate-200">User 2</span>
        </div>
        <div className="flex items-center p-2 px-4 border border-gray-200 dark:border-slate-700 bg-white dark:bg-slate-800 rounded-full shadow-sm">
          <UsersIcon />
          <span className="text-sm text-gray-700 dark:text-slate-200">...</span>
        </div>
      </div>

      <div className="py-1">
        <ArrowDownIcon />
      </div>

      <div className="w-full max-w-md text-center mb-1">
        <span className="text-xs font-semibold uppercase text-gray-500 dark:text-slate-400 tracking-wider">Organization</span>
      </div>
      <div className="flex items-center p-3 border border-blue-300 dark:border-blue-700 bg-blue-50 dark:bg-blue-900/30 rounded-lg shadow-sm min-w-[200px]">
        <OrgIcon />
        <span className="text-sm font-medium text-blue-800 dark:text-blue-200">Bluerails Org</span>
      </div>

      <div className="py-1">
        <ArrowDownIcon />
      </div>

      <div className="w-full max-w-md text-center mb-1">
        <span className="text-xs font-semibold uppercase text-gray-500 dark:text-slate-400 tracking-wider">Accounts</span>
      </div>
      <div className="flex flex-col items-center gap-2 w-full max-w-xs sm:max-w-sm">
        <div className="flex items-center p-3 border border-gray-200 dark:border-slate-700 bg-white dark:bg-slate-800 rounded-lg shadow-sm w-full">
          <AccountIcon />
          <span className="text-sm text-gray-700 dark:text-slate-200">Account 1</span>
        </div>
        <div className="flex items-center p-3 border border-gray-200 dark:border-slate-700 bg-white dark:bg-slate-800 rounded-lg shadow-sm w-full">
          <AccountIcon />
          <span className="text-sm text-gray-700 dark:text-slate-200">Account 2</span>
        </div>
        <div className="flex items-center p-3 border border-gray-200 dark:border-slate-700 bg-white dark:bg-slate-800 rounded-lg shadow-sm w-full">
          <AccountIcon />
          <span className="text-sm text-gray-700 dark:text-slate-200">...</span>
        </div>
      </div>

    </div>;
};

## What is an Organization?

In Bluerails, an **Organization** represents your business, project, or entity. It acts as the primary, top-level container that holds all of your resources and configurations within the platform.

Think of it as the root for your interactions with Bluerails. Everything you create or manage using our API or Dashboard—such as Accounts, API Keys, Payments, and Payouts—belongs to a specific Organization.

***

## Key Characteristics

* **Top-Level Container:** All other Bluerails resources are nested under an Organization. This provides structure and hierarchy.
* **Data Isolation:** Each Organization operates independently. Data and resources within one Organization (e.g., Accounts, transaction history) are completely separate and isolated from those in any other Organization.
* **Unique Identification:** While you often interact with resources like [Accounts](/concepts/accounts) directly, your Organization has a unique
  identifier assigned
  during creation.
* **Creation:** Your primary Organization is typically created automatically when you sign up for Bluerails through the Dashboard.

***

## Organizations and Other Resources

* **Accounts:** An Organization can have multiple Accounts. Each Account holds balances for specific assets (like USDC or EURC) and belongs directly to one Organization.
* **API Keys:** API keys are scoped to your Organization. When you authenticate API requests using your key, Bluerails automatically identifies which Organization you are acting on behalf of.
* **Payments & Payouts:** While Payments and Payouts are operations linked directly to specific Accounts, they occur within the context of the Organization that owns those Accounts.

<OrganizationStructureDiagram />
