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

# KYB Advanced Company Details

> KYB Advanced Company Details API Documentation

For a usage description of the KYB Advanced Company Details, please refer to the [KYB](/essentials/kyb) page.

## Endpoint

**POST** `/kyb/company/details`


## OpenAPI

````yaml POST /kyb/company/details
openapi: 3.1.0
info:
  title: Umbrella API
  version: 1.0.0
  description: >-
    API documentation for Umbrella services including KYB, KYC, AML, payments,
    phone intelligence, onboarding, and address verification.
servers:
  - url: https://api-umbrella.io/api/services
    description: Production
  - url: https://sandbox-umbrella-api.azurewebsites.net/api/services
    description: Sandbox
security:
  - bearerAuth: []
paths:
  /kyb/company/details:
    post:
      summary: Get Company Details
      description: >-
        Retrieve the full company record for a resolved entity. Use the
        `transactionId` and `companyId` from a prior `/kyb/search` call. The
        `include` object controls which data packages are returned and billed.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - transactionId
                - companyId
              properties:
                transactionId:
                  type: string
                  format: uuid
                  description: From the `/kyb/search` response.
                  example: a8b89ef3-9d93-4d96-a495-be605fd1b2fe
                companyId:
                  type: string
                  format: uuid
                  description: From the `/kyb/search` response.
                  example: 223c8dde-9c82-4811-ba3c-4f9fe648c2da
                include:
                  type: object
                  description: >-
                    Data packages to retrieve. All default to `false`. Each
                    enabled package is priced separately.
                  properties:
                    officers:
                      type: boolean
                      description: >-
                        Directors, managing partners, and authorised signatories
                        with roles, tenure, and signature rights.
                    addresses:
                      type: boolean
                      description: >-
                        All registered and business addresses (structured and
                        single-line).
                    ownerships:
                      type: boolean
                      description: >-
                        Shareholder and UBO data including holding percentages,
                        capital, and voting rights.
                    transparency:
                      type: boolean
                      description: >-
                        Transparency register entries. Returns a list with
                        `linkToken` values. Retrieve files via
                        `/kyb/company/document/retrieve`.
                    documents:
                      type: boolean
                      description: >-
                        Official company documents. Returns a list with
                        `linkToken` values. Retrieve files via
                        `/kyb/company/document/retrieve`.
                    financials:
                      type: boolean
                      description: >-
                        Financial data such as balance sheet and revenue
                        figures.
                timeoutMs:
                  type: integer
                  description: Request timeout in milliseconds.
                  example: 30000
            example:
              transactionId: a8b89ef3-9d93-4d96-a495-be605fd1b2fe
              companyId: 223c8dde-9c82-4811-ba3c-4f9fe648c2da
              include:
                officers: true
                addresses: true
                ownerships: true
                transparency: true
                documents: true
                financials: false
              timeoutMs: 30000
      responses:
        '200':
          description: Full company record.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                  data:
                    type: object
                    properties:
                      company:
                        type: object
                        properties:
                          legalName:
                            type: string
                          tradingNames:
                            type: array
                            items:
                              type: string
                          status:
                            type: string
                          companyType:
                            type: object
                            properties:
                              native:
                                type: object
                                properties:
                                  value:
                                    type: string
                                  language:
                                    type: string
                                  source:
                                    type: string
                              modeled:
                                type: object
                                properties:
                                  value:
                                    type: string
                                  scheme:
                                    type: string
                                  source:
                                    type: string
                          incorporationDate:
                            type: string
                            format: date-time
                          registrationDate:
                            type:
                              - string
                              - 'null'
                            format: date-time
                          country:
                            type: string
                          registeredAddress:
                            type: object
                            properties:
                              singleLine:
                                type: string
                              structured:
                                type: object
                                properties:
                                  line1:
                                    type:
                                      - string
                                      - 'null'
                                  line2:
                                    type:
                                      - string
                                      - 'null'
                                  city:
                                    type:
                                      - string
                                      - 'null'
                                  postalCode:
                                    type:
                                      - string
                                      - 'null'
                                  region:
                                    type:
                                      - string
                                      - 'null'
                                  country:
                                    type: string
                          businessAddress:
                            type: object
                            properties:
                              singleLine:
                                type:
                                  - string
                                  - 'null'
                              structured:
                                type: object
                                properties:
                                  line1:
                                    type:
                                      - string
                                      - 'null'
                                  line2:
                                    type:
                                      - string
                                      - 'null'
                                  city:
                                    type:
                                      - string
                                      - 'null'
                                  postalCode:
                                    type:
                                      - string
                                      - 'null'
                                  region:
                                    type:
                                      - string
                                      - 'null'
                                  country:
                                    type:
                                      - string
                                      - 'null'
                          identifiers:
                            type: array
                            items:
                              type: object
                              properties:
                                scheme:
                                  type: string
                                value:
                                  type: string
                                country:
                                  type: string
                          industryCodes:
                            type: array
                            items:
                              type: object
                              properties:
                                scheme:
                                  type: string
                                code:
                                  type: string
                                label:
                                  type: string
                          website:
                            type:
                              - string
                              - 'null'
                  metadata:
                    type: object
                    properties:
                      confidence:
                        type: number
                        minimum: 0
                        maximum: 1
                      completeness:
                        type: number
                        minimum: 0
                        maximum: 1
                      source:
                        type:
                          - string
                          - 'null'
                      sourceTst:
                        type:
                          - string
                          - 'null'
                        format: date-time
              example:
                status: true
                data:
                  company:
                    legalName: IDCANOPY GROUP LTD
                    tradingNames: []
                    status: active
                    companyType: {}
                    incorporationDate: '2025-02-19T00:00:00.000Z'
                    registrationDate: null
                    country: GB
                    registeredAddress:
                      singleLine: 71-75 Shelton Street, WC2H 9JQ London, United Kingdom
                      structured:
                        line1: 71-75 Shelton Street
                        line2: null
                        city: London
                        postalCode: WC2H 9JQ
                        region: null
                        country: GB
                    businessAddress:
                      singleLine: null
                      structured:
                        line1: null
                        line2: null
                        city: null
                        postalCode: null
                        region: null
                        country: GB
                    identifiers:
                      - scheme: REGISTRATION_NUMBER
                        value: '16262990'
                        country: GB
                    industryCodes: []
                    website: null
                metadata:
                  confidence: 0.85
                  completeness: 0.71
                  source: Companies House
                  sourceTst: '2025-06-01T10:00:00.000Z'
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Bearer token obtained from POST /auth. Valid for 60 minutes.

````