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

# Get business

> Retrieve details of a specific business



## OpenAPI

````yaml GET /v1/platform/businesses/{business_id}/
openapi: 3.0.3
info:
  title: Thredfi Accounting Platform API
  version: 1.0.0
  description: >-
    Comprehensive API for accounting, invoice management, open banking, and
    intelligence services.
servers: []
security: []
paths:
  /v1/platform/businesses/{business_id}/:
    get:
      tags:
        - Business Management
      summary: Get business
      description: Retrieve details of a specific business
      operationId: get_business
      parameters:
        - in: path
          name: business_id
          schema:
            type: string
            format: uuid
          description: A UUID string identifying this business.
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Business'
              examples:
                UKLimitedCompany:
                  value:
                    id: 3c90c3cc-0d44-4b50-8888-8dd25736052a
                    external_id: customer-123
                    legal_name: Acme Coffee Limited
                    name: Acme Coffee Ltd
                    entity_type: limited
                    phone_number: +44 20 1234 5678
                    tin: '1234567890'
                    vat_number: GB123456789
                    company_number: '12345678'
                    country: GB
                    province: Greater London
                    eu_nace_industry_code: '56.30'
                    email: accounting@acmecoffee.co.uk
                    base_currency: GBP
                    accounting_method: accrual
                    fiscal_year_end: '2024-03-31'
                    activation_at: '2024-01-15T10:30:00Z'
                    is_active: true
                    created_at: '2024-01-15T10:30:00Z'
                    updated_at: '2024-03-20T14:22:00Z'
                    metadata:
                      erp_id: ERP-12345
                      industry: hospitality
                  summary: UK Limited Company
          description: ''
      security:
        - PartnerJWT: []
        - BusinessScopedJWT: []
        - BasicAuth: []
        - BearerUnscoped: []
        - BearerBusinessScoped: []
components:
  schemas:
    Business:
      type: object
      description: Full business serializer for list and detail views
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
          description: Unique identifier for the business
        external_id:
          type: string
          description: Your unique identifier for this business
        legal_name:
          type: string
          description: Legal registered name of the business
          maxLength: 255
        name:
          type: string
          description: Display name for the business (defaults to legal_name)
          maxLength: 255
        entity_type:
          type: string
          description: Business entity type (e.g., 'limited', 'gmbh', 'bv')
        phone_number:
          type: string
          description: Business phone number
        tin:
          type: string
          description: Tax identification number (other than VAT)
        vat_number:
          type: string
          description: EU VAT registration number
        company_number:
          type: string
          description: Company registration number (e.g., Companies House number for UK)
        country:
          type: string
          description: ISO 3166-1 alpha-2 country code (e.g., GB, DE, NL, MY, SG)
          maxLength: 2
        province:
          type: string
          description: Province or state within the country
          maxLength: 100
        eu_nace_industry_code:
          type: string
          description: European NACE industry classification code
          maxLength: 10
        email:
          type: string
          format: email
          description: Primary email address for the business
        base_currency:
          type: string
          description: Base currency for accounting (ISO 4217 code)
          maxLength: 3
        accounting_method:
          type: string
          description: 'Accounting method: ''cash'' or ''accrual'''
          maxLength: 20
        fiscal_year_end:
          type: string
          format: date
          description: Fiscal year end date
        activation_at:
          type: string
          format: date-time
          readOnly: true
          description: Date and time when the business was activated
        is_active:
          type: boolean
          readOnly: true
          description: Whether the business is active (false if archived)
        created_at:
          type: string
          format: date-time
          readOnly: true
          description: Date and time when the business was created
        updated_at:
          type: string
          format: date-time
          readOnly: true
          description: Date and time when the business was last updated
        metadata:
          description: Custom JSON metadata for partner-specific data
      required:
        - accounting_method
        - activation_at
        - base_currency
        - country
        - created_at
        - email
        - fiscal_year_end
        - id
        - is_active
        - legal_name
        - updated_at
  securitySchemes:
    PartnerJWT:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Partner-level JWT token (unscoped). Token payload includes `partner_id`.
        Business access is validated via partner ownership. Format: `Bearer
        <your-jwt-token>`


        **Use this for**: Multi-business operations where the business_id is
        specified in the URL and partner has access to multiple businesses.
    BusinessScopedJWT:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Business-scoped JWT token. Token payload includes `business_id` to
        automatically scope requests. Format: `Bearer <your-jwt-token>`


        **Use this for**: Business-specific operations where the business
        context is embedded in the token.
    BasicAuth:
      type: http
      scheme: basic
      description: >-
        Basic authentication for OAuth2 token endpoint. Use partner_uuid:api_key
        as username:password. Example: Authorization: Basic
        base64(partner_uuid:api_key)
    BearerUnscoped:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Partner (unscoped) JWT Bearer token. Obtain via POST
        /v1/platform/oauth2/token with Basic auth (partner_uuid:api_key). Use
        header: Authorization: Bearer {access_token}
    BearerBusinessScoped:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Business-scoped JWT Bearer token. Obtain via POST
        /v1/platform/{business_id}/oauth2/token/ using a partner Bearer token.
        Only valid for endpoints whose URL contains that business_id.

````