> ## Documentation Index > Fetch the complete documentation index at: https://docs.joinluminous.com/llms.txt > Use this file to discover all available pages before exploring further. # Company > Get detailed information for a specific company ## OpenAPI ````yaml /api-reference/build.yaml get /companies/{companyId} openapi: 3.0.0 info: title: Luminous API version: 1.0.0 description: API documentation for Luminous servers: - url: https://{companyName}.api.joinluminous.com/external/api/v1 variables: companyName: default: companyName description: Your company-specific subdomain security: [] tags: - name: Products description: Get and manage products - name: Pricing description: Manage price schedules, levels, and customizations - name: BOMs description: Manage Bills of Materials (BOMs) - name: Labels description: Label rendering via Labelary ZPL service - name: Companies description: Manage business accounts and their associated data - name: Contacts description: Manage contact information for individuals - name: Suppliers description: Manage suppliers (factories) — vendors used on purchase orders - name: Supplier SKUs description: Manage per-supplier SKU and unit-cost overrides for products - name: Locations description: Manage warehouses and locations - name: Inventory description: Get and adjust product stock levels - name: Lots description: Create, update, and delete product lots (batches) - name: Transfer Orders description: Manage transfer orders - name: Fulfillment Orders description: Manage fulfillment orders and picklists - name: Purchase Orders description: Get and modify purchase orders - name: Receiving Reports description: Manage receiving reports - name: Payment Obligations description: Manage payment obligations for purchase orders - name: Sales Orders description: Manage sales orders and sales order shipments - name: Purgatory description: >- Inspect and resolve non-posted sales orders in the purgatory staging workflow - name: PickFlow Shipping description: >- Provider-agnostic shipping rates, services, packages, and label purchase for PickFlow - name: Cycle Counts description: >- Create, drive, and post PickFlow cycle counts — batches, per-warehouse sessions, and CSV import/export - name: Print Stations description: List paired print stations and enqueue print jobs to them - name: Invoices description: Get and manage invoices - name: Work Orders description: >- Manage work orders — production lifecycle, steps, materials, links, shipments, and comments - name: Production Batches description: Group and manage work orders as production batches - name: Bills description: >- Accounts payable bill management, payments, attachments, allocations, and variance - name: Prepayments description: Manage vendor prepayments and applications - name: Vendor Credits description: Manage vendor credits and applications - name: Vendor Returns description: Manage vendor returns and credit generation - name: Customer Returns description: Manage customer returns (sales returns), receiving, and restock behavior - name: Stock Snapshot description: Point-in-time stock snapshots with export support - name: Consumption description: Consumption reports and exports - name: Inventory Aging description: Cost-layer-based inventory aging reports - name: Bills Reports description: Accounts payable bills aging reports - name: Forecast description: Materialized forecast data - name: Reports description: Close the books, inventory discrepancy, transaction COGS, and EDI reports - name: Tags description: Add/remove tags across various resources - name: Custom Fields description: Get and set custom fields across various resources - name: Currency description: Currency configuration, exchange rates, and conversion - name: Integration Mappings description: Manage integration mappings for external systems - name: Integration Field Mappings description: Manage field-level mappings between Luminous and external systems paths: /companies/{companyId}: get: tags: - Companies summary: Company description: Get detailed information for a specific company operationId: getCompany parameters: - name: companyId in: path required: true schema: type: integer description: The unique identifier of the company responses: '200': description: Company details content: application/json: schema: type: object properties: data: type: object properties: id: type: integer description: Unique identifier for the company example: 123456 created_at: type: string format: date-time description: When the company was created example: '2023-03-15T14:30:00Z' updated_at: type: string format: date-time description: When the company was last updated example: '2023-03-15T14:30:00Z' status: type: string description: Status of the company enum: - active - inactive example: active name: type: string description: Company name example: Acme Corporation type: type: string nullable: true description: Type of business example: Retail phone: type: string nullable: true description: Primary phone number for the company example: 555-123-4567 address: type: string nullable: true description: Street address for the company example: 123 Main St address_line_2: type: string nullable: true description: Additional address information example: Suite 500 city: type: string nullable: true description: City example: Austin state: type: string nullable: true description: State/province example: TX postal_code: type: string nullable: true description: Postal/ZIP code example: '78701' country: type: string nullable: true description: Country example: USA full_address: type: string nullable: true description: Complete formatted address example: 123 Main St, Suite 500, Austin, TX 78701, USA shipping_first_name: type: string nullable: true description: First name for shipping contact (legacy field) example: John shipping_last_name: type: string nullable: true description: Last name for shipping contact (legacy field) example: Doe shipping_email: type: string format: email nullable: true description: Email for shipping contact (legacy field) example: shipping@acmecorp.com shipping_phone: type: string nullable: true description: Phone number for shipping contact (legacy field) example: 555-987-6543 shipping_address: type: string nullable: true description: Shipping street address (legacy field) example: 456 Warehouse Blvd shipping_city: type: string nullable: true description: Shipping city (legacy field) example: Austin shipping_state: type: string nullable: true description: Shipping state/province (legacy field) example: TX shipping_postal_code: type: string nullable: true description: Shipping postal/ZIP code (legacy field) example: '78745' shipping_country: type: string nullable: true description: Shipping country (legacy field) example: USA shipping_full_address: type: string nullable: true description: Complete formatted shipping address (legacy field) example: 456 Warehouse Blvd, Austin, TX 78745, USA payment_term: type: string nullable: true description: Payment terms for the company example: Net 30 tax_exempt: type: boolean nullable: true description: Whether the company is exempt from taxes example: false tax_rate: type: number format: float nullable: true description: Tax rate applied to the company's orders example: 8.25 due_date_days: type: integer nullable: true description: Number of days until payment is due example: 30 header_discount_enabled: type: boolean description: >- Whether an order-header trade discount is applied by default for this company example: false header_discount_type: type: string nullable: true enum: - PERCENT - FIXED_AMOUNT description: >- How the header discount is calculated — a percentage of the order or a fixed amount example: PERCENT header_discount_value: type: number format: float nullable: true description: >- The header discount amount — a percentage when `header_discount_type` is `PERCENT`, otherwise a fixed currency amount example: 5 header_discount_effective_from: type: string format: date nullable: true description: >- Date from which the header discount takes effect (YYYY-MM-DD) example: '2026-01-01' price_level: nullable: true description: Price level associated with this company type: object properties: id: type: number description: Unique identifier for the price level example: 123 created_at: type: string format: date-time description: When the price level was created example: '2023-03-15T14:30:00Z' updated_at: type: string format: date-time description: When the price level was last updated example: '2023-03-15T14:30:00Z' status: type: string description: Status of the price level enum: - active - inactive example: active name: type: string description: Name of the price level example: Wholesale type: type: string description: Type of the price level example: percentage percent_increase: type: number format: float description: >- Percentage increase (or decrease) for this price level example: 15.5 notes: type: string nullable: true description: Additional notes about the company example: Key account, requires special handling fein: type: string nullable: true description: Federal Employer Identification Number example: 12-3456789 tags: type: array nullable: true description: List of tags associated with the company items: type: object properties: id: type: integer description: Unique identifier for the tag name: type: string description: Name of the tag description: type: string nullable: true description: Description of the tag icon: type: string nullable: true description: Icon identifier or URL for the tag color: type: string nullable: true description: Color code for the tag required: - id - name default_shipping: nullable: true description: Default shipping address type: object properties: id: type: integer description: Unique identifier for the shipping address example: 789 created_at: type: string format: date-time description: When the shipping address was created example: '2023-03-15T14:30:00Z' updated_at: type: string format: date-time description: When the shipping address was last updated example: '2023-03-15T14:30:00Z' company_id: type: integer description: ID of the company this shipping address belongs to example: 123456 company_name: type: string nullable: true description: Name of the company example: Acme Corporation address: type: string description: Street address example: 456 Warehouse Blvd address_line_2: type: string nullable: true description: Additional address information example: Building 2 city: type: string description: City example: Austin state: type: string description: State/province example: TX postal_code: type: string description: Postal/ZIP code example: '78745' country: type: string description: Country example: USA full_address: type: string description: Complete formatted address example: >- 456 Warehouse Blvd, Building 2, Austin, TX 78745, USA full_name: type: string description: Full name of the contact person example: John Doe first_name: type: string nullable: true description: First name of the contact person example: John last_name: type: string nullable: true description: Last name of the contact person example: Doe phone: type: string nullable: true description: Phone number example: 555-987-6543 email: type: string format: email nullable: true description: Email address example: shipping@acmecorp.com is_default: type: boolean description: Whether this is the default shipping address example: true required: - id - company_id - address - city - state - postal_code - country shipping_addresses: type: array nullable: true description: List of shipping addresses for the company items: type: object properties: id: type: integer description: Unique identifier for the shipping address example: 789 created_at: type: string format: date-time description: When the shipping address was created example: '2023-03-15T14:30:00Z' updated_at: type: string format: date-time description: When the shipping address was last updated example: '2023-03-15T14:30:00Z' company_id: type: integer description: >- ID of the company this shipping address belongs to example: 123456 company_name: type: string nullable: true description: Name of the company example: Acme Corporation address: type: string description: Street address example: 456 Warehouse Blvd address_line_2: type: string nullable: true description: Additional address information example: Building 2 city: type: string description: City example: Austin state: type: string description: State/province example: TX postal_code: type: string description: Postal/ZIP code example: '78745' country: type: string description: Country example: USA full_address: type: string description: Complete formatted address example: >- 456 Warehouse Blvd, Building 2, Austin, TX 78745, USA full_name: type: string description: Full name of the contact person example: John Doe first_name: type: string nullable: true description: First name of the contact person example: John last_name: type: string nullable: true description: Last name of the contact person example: Doe phone: type: string nullable: true description: Phone number example: 555-987-6543 email: type: string format: email nullable: true description: Email address example: shipping@acmecorp.com is_default: type: boolean description: Whether this is the default shipping address example: true required: - id - company_id - address - city - state - postal_code - country billing_info: type: object nullable: true description: Billing information properties: id: type: integer example: 456 created_at: type: string format: date-time example: '2023-03-15T14:30:00Z' updated_at: type: string format: date-time example: '2023-03-15T14:30:00Z' first_name: type: string nullable: true example: Jane last_name: type: string nullable: true example: Smith email: type: string format: email nullable: true example: accounting@acmecorp.com receiving_bank_name: type: string nullable: true example: First National Bank receiving_bank_address: type: string nullable: true example: 789 Finance Street, Austin, TX 78701 client_type: type: object nullable: true description: Type of client properties: id: type: integer example: 123 created_at: type: string format: date-time example: '2023-03-15T14:30:00Z' updated_at: type: string format: date-time example: '2023-03-15T14:30:00Z' name: type: string example: Retail description: type: string nullable: true example: Retail business client parent_company_id: type: integer nullable: true description: ID of the parent company example: 456 invoice_export_template_id: type: integer nullable: true description: ID of the invoice export template example: 789 custom_fields: type: object description: Custom fields for the company example: Industry: Manufacturing Region: Southwest Annual Revenue: $5M-$10M assigned_sales_reps: type: array description: > Sales rep users assigned to this company (Go Team members). Resolved from the company's `goTeamMember.user` relation. Only present when the relation is loaded. items: type: object properties: id: type: integer description: User ID of the assigned sales rep example: 42 email: type: string description: >- Email of the assigned sales rep (PII-hashed when PII filtering is enabled) example: rep@example.com first_name: type: string nullable: true example: Jane last_name: type: string nullable: true example: Doe sales_channel: allOf: - type: object properties: id: type: integer description: Sales channel ID. status: type: string description: Sales channel status (e.g. active). label: type: string nullable: true description: Human-readable channel label. channel_type: type: string nullable: true description: >- Channel type (e.g. the integration/platform the channel represents). created_at: type: string format: date-time updated_at: type: string format: date-time nullable: true description: >- The company's default sales channel. Only present when the relation is loaded. required: - id - name - status '401': description: Authentication credentials were missing or invalid content: application/json: schema: type: object properties: error: type: string example: Unauthorized message: type: string example: Authentication credentials are missing or invalid status_code: type: integer example: 401 '403': description: You do not have permission to perform this action content: application/json: schema: type: object properties: error: type: string example: Forbidden message: type: string example: You do not have permission to access this resource status_code: type: integer example: 403 '404': description: The requested resource was not found content: application/json: schema: type: object properties: error: type: string example: Not Found message: type: string example: The requested resource could not be found status_code: type: integer example: 404 security: - BearerAuth: [] components: securitySchemes: BearerAuth: type: http scheme: bearer description: >- Authenticate using a bearer token. To create a token, navigate to /settings/api-tokens and click Create API Token. ````