Skip to main content

company

Retrieve a specific company by its internal identifier.

Key Features:

  • Returns complete company information including business details and contact information
  • Includes organizational structure and business relationships
  • Supports federation for cross-service data access

Business Rules:

  • Company must exist and be accessible to the requesting user
  • Access is controlled by user roles and permissions
  • Returns all company data including managers, addresses, and purchase authorization configs

Error Scenarios:

  • COMPANY_NOT_FOUND_ERROR: When company with specified ID does not exist
  • COMPANY_FETCH_ERROR: When system fails to retrieve company data
  • ACCESS_DENIED_ERROR: When user lacks permission to access company

Use Cases:

  • Company profile viewing and management
  • Business relationship verification
  • Organizational structure analysis
  • Cross-service data federation

AUTH: Role=[user.OWNER,user.EDITOR,user.VIEWER] OR (('user is authenticated') AND ('companyId(s) if present in input matches JWT'))

company(
  id: Int!
): Company!

Arguments​

company.id ● Int! non-null scalar​

Unique internal identifier for the company used for system operations and data relationships

Type​

Company object​

Company entity representing business organizations and corporate entities.

External entity from the company service that provides company identification and business information. Used as a reference for company-specific attributes and organizational relationships within the attribute system.