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

# Send the information request to the applicant

> The only moment anything reaches the applicant. In one transaction the backend snapshots each requested target's current state (the "was" of the dashboard's was-to-now: a field's value, or the id + name of every file a requested document group holds), reopens exactly those targets, moves the case to `in_remediation` and unlocks it so the widget accepts writes again. Nothing else becomes editable: no other field, no other document group, and no owner.

The body is `{"notify": true}` and carries **no recipient** — the backend resolves the address from the representative email in the form, so an API client cannot redirect the widget link somewhere else. The applicant email is a later slice; the response's `widget_url` is the link to pass on in the meantime (empty when no widget base URL is configured for the environment).



## OpenAPI

````yaml https://api.dataspike.io/openapi/kyb/public.json post /webapi/v4/kyb/organization/{organizationId}/verifications/{caseId}/info-request/send
openapi: 3.1.0
info:
  description: Know Your Business (KYB) — case creation and the embedded onboarding widget.
  title: Dataspike KYB API
  version: '1.0'
servers: []
security: []
paths:
  /webapi/v4/kyb/organization/{organizationId}/verifications/{caseId}/info-request/send:
    post:
      tags:
        - KYB Remediation
      summary: Send the information request to the applicant
      description: >-
        The only moment anything reaches the applicant. In one transaction the
        backend snapshots each requested target's current state (the "was" of
        the dashboard's was-to-now: a field's value, or the id + name of every
        file a requested document group holds), reopens exactly those targets,
        moves the case to `in_remediation` and unlocks it so the widget accepts
        writes again. Nothing else becomes editable: no other field, no other
        document group, and no owner.


        The body is `{"notify": true}` and carries **no recipient** — the
        backend resolves the address from the representative email in the form,
        so an API client cannot redirect the widget link somewhere else. The
        applicant email is a later slice; the response's `widget_url` is the
        link to pass on in the meantime (empty when no widget base URL is
        configured for the environment).
      operationId: >-
        POST_/webapi/v4/kyb/organization/:organizationId/verifications/:caseId/info-request/send
      parameters:
        - description: Organization id.
          in: path
          name: organizationId
          required: true
          schema:
            type: string
        - description: KYB case id (the `id` from the list).
          in: path
          name: caseId
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SendInfoRequestRequest'
          application/xml:
            schema:
              $ref: '#/components/schemas/SendInfoRequestRequest'
        description: Request body for kyb.SendInfoRequestRequest
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: d5293a33-1d10-4aa2-8ff9-4a2c9a2d1e19
            application/xml:
              schema:
                $ref: d5293a33-1d10-4aa2-8ff9-4a2c9a2d1e19
          description: OK
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrCaseNotFound'
            application/xml:
              schema:
                $ref: '#/components/schemas/ErrCaseNotFound'
          description: Case not found.
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrRequestEmpty'
            application/xml:
              schema:
                $ref: '#/components/schemas/ErrRequestEmpty'
          description: >-
            The case is not open to remediation, or the round has nothing to
            send.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InfoRequest'
            application/xml:
              schema:
                $ref: '#/components/schemas/InfoRequest'
          description: Round sent; the case is in_remediation.
      security:
        - Session: []
components:
  schemas:
    SendInfoRequestRequest:
      description: SendInfoRequestRequest schema
      properties:
        notify:
          example: true
          type: boolean
      type: object
    ErrCaseNotFound:
      description: ErrCaseNotFound schema
      example:
        code: case_not_found
        message: Case not found
      properties:
        code:
          example: email_otp_expired
          type: string
        message:
          example: OTP has expired
          type: string
        param:
          nullable: true
          type: string
      type: object
    ErrRequestEmpty:
      description: ErrRequestEmpty schema
      example:
        code: request_empty
        message: The information request has no items to send
      properties:
        code:
          example: email_otp_expired
          type: string
        message:
          example: OTP has expired
          type: string
        param:
          nullable: true
          type: string
      type: object
    InfoRequest:
      description: InfoRequest schema
      properties:
        case_id:
          example: 019f179b-0fa7-72c8-818e-819652540477
          type: string
        case_status:
          example: in_remediation
          type: string
        created_at:
          format: date-time
          type: string
        id:
          example: 019f179b-0fa7-72c8-818e-819652540477
          type: string
        items:
          items:
            properties:
              audience:
                enum:
                  - merchant
                example: merchant
                type: string
              canceled_at:
                format: date-time
                nullable: true
                type: string
              created_at:
                format: date-time
                type: string
              created_by:
                example: 019f1383-8f38-7d31-b921-39310a19b444
                type: string
              field_key:
                example: registration_number
                type: string
              id:
                example: 019f179b-0fa7-72c8-818e-819652540477
                type: string
              last_value:
                nullable: true
              message:
                example: The number does not match the registry, please re-enter it.
                type: string
              new_value:
                nullable: true
              request_id:
                example: 019f179b-0fa7-72c8-818e-819652540477
                type: string
              resolved_at:
                format: date-time
                nullable: true
                type: string
              section_key:
                example: registration
                type: string
              status:
                enum:
                  - open
                  - resolved
                  - canceled
                example: open
                type: string
              target_kind:
                enum:
                  - field
                  - document
                example: field
                type: string
            type: object
          type: array
        received_at:
          format: date-time
          nullable: true
          type: string
        sent_at:
          format: date-time
          nullable: true
          type: string
        status:
          enum:
            - draft
            - sent
            - received
            - canceled
          example: draft
          type: string
        widget_url:
          example: https://kyb.dataspike.io/KYB0123456789abcdef
          nullable: true
          type: string
      type: object
  securitySchemes:
    Session:
      description: Session cookie for web dashboard authentication.
      in: cookie
      name: ds-prod-session
      type: apiKey

````