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

# Get a due diligence case



## OpenAPI

````yaml /contracts/svrn-integration-api.json get /due-diligence/{due_diligence_id}
openapi: 3.0.3
info:
  title: SVRN Sequential Client API
  version: '2026-04-27'
  description: >-
    OpenAPI spec generated from scripts/dux_requests and the current Lambda
    handlers. This reflects the real sequential client flow used by DUX and
    corrects the main mismatches in the published docs: POST /auth authenticates
    with X-Client-Id and X-Client-Secret headers, POST
    /onboarding/{customer_id}/create-bank-account is the active bank-account
    route, POST /due-diligence/init returns a due_diligence_id plus
    contracts_preview while upload URLs are requested separately via POST
    /due-diligence/{due_diligence_id}/uploads, and due diligence signature
    confirmation is not a client API step because it is performed by the signer
    through an emailed link outside the integrator flow.
servers:
  - url: https://api.sandbox.svrn.digital
    description: Sandbox
  - url: https://api.svrn.digital
    description: Production
security:
  - bearerAuth: []
tags:
  - name: 01 Authentication
    description: Bearer token issuance for client integrations.
  - name: 02 Onboarding
    description: >-
      Customer onboarding, listing, verification resumption, and artist PIX
      registration.
  - name: 03 Due Diligence
    description: >-
      Case creation, file upload URL issuance, offer publication, and status
      polling. Signature confirmation happens out-of-band through emailed links.
  - name: 04 Reconciliation
    description: >-
      Contract reconciliation initialization, file upload URL issuance, and
      settlement tracking.
paths:
  /due-diligence/{due_diligence_id}:
    get:
      tags:
        - 03 Due Diligence
      summary: Get a due diligence case
      operationId: getDueDiligence
      parameters:
        - name: due_diligence_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Current due diligence state.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DueDiligenceResponse'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  schemas:
    DueDiligenceResponse:
      type: object
      properties:
        due_diligence_id:
          type: string
          format: uuid
        status:
          type: string
        artist:
          $ref: '#/components/schemas/PartySnapshot'
        label:
          $ref: '#/components/schemas/PartySnapshot'
        artist_wallets:
          $ref: '#/components/schemas/WalletSnapshot'
        label_wallets:
          $ref: '#/components/schemas/WalletSnapshot'
        isrcs:
          type: array
          items:
            $ref: '#/components/schemas/DueDiligenceIsrcResponse'
        contracts_preview:
          type: array
          items:
            $ref: '#/components/schemas/ContractPreview'
        contracts:
          type: array
          items:
            $ref: '#/components/schemas/DueDiligenceContract'
        summary:
          $ref: '#/components/schemas/DueDiligenceSummary'
        credit_offer:
          allOf:
            - $ref: '#/components/schemas/CreditOffer'
          nullable: true
        fingerprint:
          type: string
          nullable: true
        signatures:
          allOf:
            - $ref: '#/components/schemas/DueDiligenceSignatures'
          nullable: true
        created_at:
          type: string
          format: date-time
        expires_at:
          type: string
          format: date-time
    PartySnapshot:
      type: object
      properties:
        customer_id:
          type: string
          format: uuid
        name:
          type: string
        email:
          type: string
          format: email
        tax_id:
          type: string
        country:
          type: string
        type:
          type: string
        role:
          type: string
        lumx_customer_id:
          type: string
        default_wallet:
          type: string
      additionalProperties: true
    WalletSnapshot:
      type: object
      properties:
        default_wallet:
          type: string
        wallets:
          type: array
          items:
            $ref: '#/components/schemas/Wallet'
      additionalProperties: true
    DueDiligenceIsrcResponse:
      type: object
      properties:
        isrc:
          type: string
        artist_split_percentage:
          $ref: '#/components/schemas/NumericStringOrNumber'
        channels:
          type: array
          items:
            type: string
        dsp_statements:
          type: array
          items:
            $ref: '#/components/schemas/DspStatement'
        revenue:
          $ref: '#/components/schemas/RevenueByChannel'
        artist_share_ttm:
          $ref: '#/components/schemas/NumericStringOrNumber'
      additionalProperties: true
    ContractPreview:
      type: object
      properties:
        isrc:
          type: string
        artist_split_percentage:
          $ref: '#/components/schemas/NumericStringOrNumber'
        dsp_statements:
          type: array
          items:
            $ref: '#/components/schemas/DspStatement'
    DueDiligenceContract:
      type: object
      properties:
        contract_id:
          type: string
        split_contract_address:
          type: string
        artist_split_percentage:
          $ref: '#/components/schemas/NumericStringOrNumber'
        dsp_statements:
          type: array
          items:
            $ref: '#/components/schemas/DspStatement'
        split_deployment_block:
          $ref: '#/components/schemas/StringOrInteger'
        split_deployment_tx_hash:
          type: string
        status:
          type: string
        isrc:
          type: string
      additionalProperties: true
    DueDiligenceSummary:
      type: object
      properties:
        total_revenue_ttm:
          $ref: '#/components/schemas/NumericStringOrNumber'
        total_artist_revenue_ttm:
          $ref: '#/components/schemas/NumericStringOrNumber'
      additionalProperties: true
    CreditOffer:
      type: object
      properties:
        advance_amount:
          $ref: '#/components/schemas/NumericStringOrNumber'
        credit_fee_percentage:
          $ref: '#/components/schemas/NumericStringOrNumber'
        credit_fee_amount:
          $ref: '#/components/schemas/NumericStringOrNumber'
        total_recoupable_amount:
          $ref: '#/components/schemas/NumericStringOrNumber'
        creditor_customer_id:
          type: string
          format: uuid
        creditor_lumx_customer_id:
          type: string
        creditor_partner_id:
          type: string
          format: uuid
        creditor_name:
          type: string
        creditor_email:
          type: string
          format: email
        creditor_bank_account_id:
          type: string
        creditor_kyc_status:
          type: string
        creditor_wallet_address:
          type: string
      additionalProperties: true
    DueDiligenceSignatures:
      type: object
      properties:
        artist:
          allOf:
            - $ref: '#/components/schemas/SignatureConfirmation'
          nullable: true
          additionalProperties: true
        label:
          allOf:
            - $ref: '#/components/schemas/SignatureConfirmation'
          nullable: true
          additionalProperties: true
        wallet_attestations:
          type: array
          items:
            $ref: '#/components/schemas/WalletAttestation'
        signed_at:
          type: string
          format: date-time
          nullable: true
        contract_signatures:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/ContractSignatureStatus'
      additionalProperties: true
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: string
        message:
          type: string
      example:
        error: MISSING_FIELD
        message: artist.customer_id is required
    Wallet:
      type: object
      properties:
        address:
          type: string
        blockchain:
          type: string
        default:
          type: boolean
        isDefault:
          type: boolean
        blockExplorerUrl:
          type: string
          format: uri
      additionalProperties: true
    NumericStringOrNumber:
      oneOf:
        - type: string
          pattern: ^-?\d+(\.\d+)?$
        - type: number
    DspStatement:
      type: object
      required:
        - channel
        - format
      properties:
        channel:
          type: string
          example: spotify
        format:
          type: string
          enum:
            - csv
            - xlsx
    RevenueByChannel:
      type: object
      additionalProperties:
        $ref: '#/components/schemas/RevenueByPeriod'
      example:
        spotify:
          2026Q1: '0.3'
    StringOrInteger:
      oneOf:
        - type: string
          pattern: ^-?\d+$
        - type: integer
    SignatureConfirmation:
      type: object
      properties:
        confirmed_at:
          type: string
          format: date-time
        source_ip:
          type: string
        customer_id:
          type: string
          format: uuid
      additionalProperties: true
    WalletAttestation:
      type: object
      properties:
        contract_id:
          type: string
        isrc:
          type: string
        artist_split_percentage:
          $ref: '#/components/schemas/NumericStringOrNumber'
        dsp_statements:
          type: array
          items:
            $ref: '#/components/schemas/DspStatement'
        contract_fingerprint:
          type: string
        artist_wallet:
          type: string
        label_wallet:
          type: string
        attested_at:
          type: string
          format: date-time
        explorer_url:
          type: string
          format: uri
        block:
          $ref: '#/components/schemas/StringOrInteger'
      additionalProperties: true
    ContractSignatureStatus:
      type: object
      properties:
        artist:
          allOf:
            - $ref: '#/components/schemas/SignatureConfirmation'
          nullable: true
          additionalProperties: true
        label:
          allOf:
            - $ref: '#/components/schemas/SignatureConfirmation'
          nullable: true
          additionalProperties: true
        signed_at:
          type: string
          format: date-time
          nullable: true
        contract_fingerprint:
          type: string
        artist_split_percentage:
          $ref: '#/components/schemas/NumericStringOrNumber'
        dsp_statements:
          type: array
          items:
            $ref: '#/components/schemas/DspStatement'
      additionalProperties: true
    RevenueByPeriod:
      type: object
      additionalProperties:
        $ref: '#/components/schemas/NumericStringOrNumber'
      example:
        2026Q1: '0.3'
  responses:
    NotFound:
      description: The target resource was not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.