orgid

Orgid, short for organization identifier, is a generic term used in software systems to refer to a unique identifier assigned to an organization within a particular scope, such as a directory, account, or tenant. It can be numeric or alphanumeric and is typically created by a service provider, administrator, or system during onboarding. An orgid is distinct from a company name, domain, or display label, serving instead as a stable, machine-readable key used to reference the organization across APIs, databases, and configuration.

Usage and scope

In cloud platforms, identity management systems, and multi-tenant software, an orgid is used to target resources, policies, and data to a specific organization. It commonly appears as a parameter or field in API calls, configuration files, or access tokens to scope actions to the correct tenant or directory. In databases, orgid often serves as a foreign key linking records to the corresponding organization record, enabling data partitioning and access control.

Characteristics

Orgids are typically designed to be immutable and globally unique within the system. They may be assigned automatically at creation or generated by a centralized directory. Some implementations separate the internal orgid from user-facing names or aliases, to preserve readability in interfaces while preserving a stable identifier for programmatic use.

Security and privacy

Revealing an orgid can disclose organizational structure to an observer, so it should be handled with appropriate access controls. Authorization checks should validate that a requester is permitted to act within the scoped organization, and the exposure of orgids should be minimized where possible.

See also

Organization, Tenant, Identifier, Directory services.