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

# Get One Check's Document Requests

> Get everything we have asked for on one verification check, newest request first. Documents you have already sent come back as short-lived download links. Use the `key` on each item to name your file parts when you answer.



## OpenAPI

````yaml GET /v1/platform/compliance/checks/{check_id}/document-requests
openapi: 3.1.0
info:
  title: Finogate Platform API v1
  version: 0.1.0
servers:
  - url: https://api-sandbox.finogates.com
    description: Sandbox
  - url: https://api.finogates.com
    description: Production
security: []
tags:
  - name: auth
  - name: users
  - name: payees
  - name: verification
  - name: bank accounts
  - name: card processing
  - name: digital-assets
  - name: international
  - name: fees
  - name: onboarding
  - name: pending-applications
  - name: wallets
  - name: payments
  - name: document mailing
  - name: merchant onboarding
  - name: catalog
  - name: webhooks
  - name: screening
  - name: Platform - File Scanning
  - name: phone-numbers
  - name: sms
  - name: calls
  - name: listings
  - name: Card Transfers
  - name: embed-tokens
paths:
  /v1/platform/compliance/checks/{check_id}/document-requests:
    get:
      tags:
        - verification
      summary: Get One Check's Document Requests
      description: >-
        Get everything we have asked for on one verification check, newest
        request first. Documents you have already sent come back as short-lived
        download links. Use the `key` on each item to name your file parts when
        you answer.
      operationId: >-
        get_platform_check_document_requests_v1_platform_compliance_checks__check_id__document_requests_get
      parameters:
        - name: check_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            description: >-
              The verification check's ID — the `kyc_record_id` or
              `kyb_record_id` from the list endpoint, from a
              `compliance_documents.*` webhook, or from the `user_kyc.*` /
              `user_kyb.*` verification webhooks. They are all the same value.
            examples:
              - 9f0b1c2d-3e4f-5061-7283-94a5b6c7d8e9
            title: Check Id
          description: >-
            The verification check's ID — the `kyc_record_id` or `kyb_record_id`
            from the list endpoint, from a `compliance_documents.*` webhook, or
            from the `user_kyc.*` / `user_kyb.*` verification webhooks. They are
            all the same value.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/CommonResponse_PlatformDocumentRequestListRead_
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - _AuthenticatedBearer: []
components:
  schemas:
    CommonResponse_PlatformDocumentRequestListRead_:
      properties:
        status_code:
          type: integer
          title: Status Code
          description: HTTP status code for the response.
        data:
          $ref: '#/components/schemas/PlatformDocumentRequestListRead'
          description: Payload or error details.
        query_generated_time:
          type: integer
          title: Query Generated Time
          description: >-
            UTC timestamp (milliseconds since epoch) when response was
            generated.
      type: object
      required:
        - status_code
        - data
        - query_generated_time
      title: CommonResponse[PlatformDocumentRequestListRead]
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    PlatformDocumentRequestListRead:
      properties:
        check_type:
          type: string
          title: Check Type
        subject_scope:
          anyOf:
            - type: string
            - type: 'null'
          title: Subject Scope
          description: >-
            ``user`` when the check is about one of your users, ``tenant`` when
            it is about your own platform.
        subject_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Subject Name
        has_open_request:
          type: boolean
          title: Has Open Request
          default: false
        kyc_record_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Kyc Record Id
          description: >-
            The identity check this belongs to. Present on ``kyc`` and ``mkyc``
            checks; the same value the ``user_kyc.*`` webhooks send.
        kyb_record_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Kyb Record Id
          description: >-
            The business check this belongs to. Present on ``kyb`` checks; the
            same value the ``user_kyb.*`` webhooks send.
        subject_user_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Subject User Id
          description: Absent on a ``tenant``-scope check.
        requests:
          items:
            $ref: '#/components/schemas/PlatformDocumentRequestRead'
          type: array
          title: Requests
      type: object
      required:
        - check_type
      title: PlatformDocumentRequestListRead
      description: The document requests on one verification check.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    PlatformDocumentRequestRead:
      properties:
        status:
          type: string
          enum:
            - open
            - completed
            - cancelled
          title: Status
        outstanding_required:
          type: integer
          title: Outstanding Required
          description: Required items still unanswered. Zero once the round is done.
          default: 0
        note:
          anyOf:
            - type: string
            - type: 'null'
          title: Note
          description: Message from the reviewer who raised the request.
        requested_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Requested At
        completed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Completed At
        cancel_reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Cancel Reason
          description: Why the reviewer withdrew a ``cancelled`` round.
        id:
          type: string
          format: uuid
          title: Id
          description: Pass this as ``request_id`` when submitting.
        items:
          items:
            $ref: '#/components/schemas/PlatformDocumentItemRead'
          type: array
          title: Items
      type: object
      required:
        - status
        - id
      title: PlatformDocumentRequestRead
      description: |-
        One round of questions against a verification check.

        The check's id is not repeated here — it is on the enclosing object, and
        one round can only belong to one check.
    PlatformDocumentItemRead:
      properties:
        label:
          type: string
          title: Label
        kind:
          type: string
          enum:
            - text
            - file
          title: Kind
        required:
          type: boolean
          title: Required
          default: true
        responded:
          type: boolean
          title: Responded
          default: false
        help:
          anyOf:
            - type: string
            - type: 'null'
          title: Help
        text:
          anyOf:
            - type: string
            - type: 'null'
          title: Text
          description: Present on answered ``text`` items.
        file_name:
          anyOf:
            - type: string
            - type: 'null'
          title: File Name
        download_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Download Url
          description: >-
            Short-lived link to a document already sent. Absent on unanswered
            items, and on a stored file that could not be signed.
        expires_in:
          anyOf:
            - type: integer
            - type: 'null'
          title: Expires In
          description: Seconds until ``download_url`` stops working.
        submitted_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Submitted At
        key:
          type: string
          title: Key
      type: object
      required:
        - label
        - kind
        - key
      title: PlatformDocumentItemRead
      description: One thing being asked for, and the answer if it has been sent.
  securitySchemes:
    _AuthenticatedBearer:
      type: oauth2
      flows:
        password:
          scopes: {}
          tokenUrl: /v1/platform/auth/token

````