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

# Get Single Order

> Retrieve a single order and retrieval details



## OpenAPI

````yaml /openapi/company_v2.yaml get /orders/{orderId}
openapi: 3.0.3
info:
  title: Kyckr Companies V2 API
  version: '2.0'
  contact:
    url: https://www.kyckr.com
  description: |
    Kyckr Companies V2 API
  license:
    name: Kyckr API License
    url: https://www.kyckr.com/legal
  termsOfService: https://www.kyckr.com/legal
servers:
  - url: https://api.kyckr.com/v2
    description: Production
  - url: https://test-api.kyckr.com/v2
    description: Testing
security:
  - AuthHeader: []
tags:
  - name: Companies
  - name: Orders
  - name: PREVIEW UBO Verify
    description: >-
      Endpoints for analyzing company ownership structure and ultimate
      beneficial owners
paths:
  /orders/{orderId}:
    parameters:
      - schema:
          type: string
        name: orderId
        in: path
        required: true
    get:
      tags:
        - Orders
      summary: Get Single Order
      description: Retrieve a single order and retrieval details
      operationId: get-orders-orderId
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/BaseResponse'
                  - type: object
                    properties:
                      data:
                        $ref: '#/components/schemas/OrderDetails'
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
        '403':
          $ref: '#/components/responses/403Response'
        '404':
          $ref: '#/components/responses/404Response'
        '410':
          $ref: '#/components/responses/ErrorResponse'
components:
  schemas:
    BaseResponse:
      title: BaseResponse
      type: object
      properties:
        orderId:
          type: number
          example: 12345
          description: The related orderId.
        correlationId:
          type: string
          description: "The related correlationId to this request, for support purposes. \r\n"
        customerReference:
          type: string
          description: A customer provided reference, which appears in the order list.
        timeStamp:
          type: string
          format: date-time
          description: The UTC time at which the request occurred.
        details:
          type: string
          description: 'The response status details for the current request.  '
        cost:
          $ref: '#/components/schemas/Cost'
        links:
          type: object
          properties:
            self:
              type: string
              format: uri-reference
              example: /orders/12345
      description: ''
    OrderDetails:
      title: OrderDetails
      type: object
      properties:
        orderId:
          type: string
          example: '12345'
        orderDate:
          type: string
          example: '2023-01-01T00:00:00Z'
          format: date-time
        customerReference:
          type: string
          description: Optional reference supplied by user
        status:
          type: string
          enum:
            - Success
            - Pending
            - Failed
          description: Status of order
        cost:
          $ref: '#/components/schemas/Cost'
        user:
          type: string
          format: uri-reference
          example: /users/12345
          description: URL reference to user who placed order
        productDetails:
          type: object
          description: Product detail fields from the order.
          properties:
            productName:
              type: string
              example: Annual Accounts 2021-22
              description: The name of the ordered product
            productId:
              type: string
              description: The unique identifier of the ordered product
              example: ROWOFF_SVRBX0VDUF8wMQ==_RXh0ZW5kZWQgUHJvZmlsZQ==
            productCategory:
              type: string
              description: The category of the ordered product
              example: Financial Information
            productType:
              type: string
              description: >
                🚧 Preview — planned, not yet available in production.
                Machine-readable payload type for products with a structured
                JSON payload. Matches the `_payloadType` discriminator family on
                `GET /v2/orders/{orderId}/download?format=json` (e.g.
                `BO_PROFILE`, `ENHANCED_PROFILE`). Absent for PDF-only products
                such as documents or filings.
              example: BO_PROFILE
            schemaVersion:
              type: string
              description: >
                🚧 Preview — planned, not yet available in production. Schema
                version of the delivered structured JSON payload. Absent for
                PDF-only products. When the delivered version is in deprecation,
                the download response carries Sunset (RFC 8594) and Deprecation
                (RFC 9745) headers.
              example: '2.0'
        companyDetails:
          type: object
          description: The name of the company referred to in the order
          properties:
            companyName:
              type: string
              example: Kyckr Limited
              description: The number of the company referred to in the order
            companyNumber:
              type: string
              example: R123456
              description: The number of the company referred to in the order
            kyckrID:
              type: string
              example: IE|UjEyMzQ1Ng==
              description: The Kyckr ID of the company referred to in the order
        links:
          type: object
          properties:
            data:
              type: string
              format: uri-reference
              example: /orders/12345/download?format=json
              description: URL reference to structured data format
            document:
              type: string
              format: uri-reference
              example: /orders/12345/download?format=pdf
              description: URL reference to document format
    Cost:
      type: object
      description: Cost of an item
      properties:
        type:
          type: string
          enum:
            - credit
            - lite
          example: credit
        value:
          type: number
          example: 3
    ProblemDetails:
      title: Problem Details
      type: object
      properties:
        type:
          type: string
        title:
          type: string
        detail:
          type: string
        errors:
          type: array
          items:
            type: string
  responses:
    400Response:
      description: Bad request
      content:
        application/json:
          schema:
            allOf:
              - $ref: '#/components/schemas/BaseResponse'
              - type: object
                properties:
                  data:
                    $ref: '#/components/schemas/ProblemDetails'
          examples:
            Missing Parameter:
              value:
                orderId: 12345
                correlationId: string
                customerReference: string
                timeStamp: '2019-08-24T14:15:22Z'
                details: string
                cost:
                  type: credit
                  value: 0
                links:
                  self: ../dictionary
                data:
                  type: https://httpstatuses.com/400
                  title: Missing Parameter
                  detail: The `isoCode` parameter is required
                  errors: []
    401Response:
      description: Unauthorized
      content:
        application/json:
          schema:
            allOf:
              - $ref: '#/components/schemas/BaseResponse'
              - type: object
                properties:
                  data:
                    $ref: '#/components/schemas/ProblemDetails'
          examples:
            Unauthorized:
              value:
                orderId: 12345
                correlationId: string
                customerReference: string
                timeStamp: '2019-08-24T14:15:22Z'
                details: string
                cost:
                  type: credit
                  value: 0
                links:
                  self: ../dictionary
                data:
                  type: https://httpstatuses.com/401
                  title: Unauthorized
                  detail: Please authorize before making requests
                  errors: []
    403Response:
      description: Forbidden
      content:
        application/json:
          schema:
            allOf:
              - $ref: '#/components/schemas/BaseResponse'
              - type: object
                properties:
                  data:
                    $ref: '#/components/schemas/ProblemDetails'
          examples:
            Forbidden:
              value:
                orderId: 12345
                correlationId: string
                customerReference: string
                timeStamp: '2019-08-24T14:15:22Z'
                details: string
                cost:
                  type: credit
                  value: 0
                links:
                  self: ../dictionary
                data:
                  type: https://httpstatuses.com/403
                  title: Forbidden
                  detail: This feature is not available on this account
                  errors: []
    404Response:
      description: Not Found
      content:
        application/json:
          schema:
            allOf:
              - $ref: '#/components/schemas/BaseResponse'
              - type: object
                properties:
                  data:
                    $ref: '#/components/schemas/ProblemDetails'
          examples:
            Not Found:
              value:
                orderId: 12345
                correlationId: string
                customerReference: string
                timeStamp: '2019-08-24T14:15:22Z'
                details: string
                cost:
                  type: credit
                  value: 0
                links:
                  self: ../dictionary
                data:
                  type: https://httpstatuses.com/404
                  title: Not Found
                  detail: This resource could not be found
                  errors: []
    ErrorResponse:
      description: Error
      content:
        application/json:
          schema:
            allOf:
              - $ref: '#/components/schemas/BaseResponse'
              - type: object
                properties:
                  data:
                    $ref: '#/components/schemas/ProblemDetails'
      headers:
        Location:
          schema:
            type: string
          description: 'URL of '
  securitySchemes:
    AuthHeader:
      type: http
      scheme: bearer

````