> ## 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.

# List Verification Document Requests

> List every verification check of yours that we have asked for extra documents on. Use `status=open` to see just what you still owe us. This is the endpoint to poll if you did not receive, or missed, the `compliance_documents.requested` webhook.

Each check comes back under `kyc_record_id` or `kyb_record_id` depending on its `check_type` — the same id, and the same field name, the `user_kyc.*` / `user_kyb.*` webhooks use.



## OpenAPI

````yaml GET /v1/platform/compliance/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/document-requests:
    get:
      tags:
        - verification
      summary: List Verification Document Requests
      description: >-
        List every verification check of yours that we have asked for extra
        documents on. Use `status=open` to see just what you still owe us. This
        is the endpoint to poll if you did not receive, or missed, the
        `compliance_documents.requested` webhook.


        Each check comes back under `kyc_record_id` or `kyb_record_id` depending
        on its `check_type` — the same id, and the same field name, the
        `user_kyc.*` / `user_kyb.*` webhooks use.
      operationId: >-
        list_platform_document_requests_v1_platform_compliance_document_requests_get
      parameters:
        - name: status
          in: query
          required: false
          schema:
            anyOf:
              - enum:
                  - open
                  - completed
                  - cancelled
                type: string
              - type: 'null'
            description: >-
              Show only requests in this state — `open` (we are still waiting on
              you), `completed`, or `cancelled`. Leave it out for all of them. A
              check whose requests span several states is listed under each,
              carrying only the matching requests.
            title: Status
          description: >-
            Show only requests in this state — `open` (we are still waiting on
            you), `completed`, or `cancelled`. Leave it out for all of them. A
            check whose requests span several states is listed under each,
            carrying only the matching requests.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 200
            minimum: 1
            description: How many checks to return per page (1 to 200).
            default: 50
            title: Limit
          description: How many checks to return per page (1 to 200).
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            description: How many checks to skip before this page starts.
            default: 0
            title: Offset
          description: How many checks to skip before this page starts.
      responses:
        '200':
          description: The verification checks that have document requests.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/ListResponse_list_PlatformDocumentRequestListRead__
              example:
                status_code: 200
                data:
                  - check_type: kyb
                    subject_scope: user
                    subject_name: Lovelace Analytics LLC
                    has_open_request: true
                    kyb_record_id: 9f0b1c2d-3e4f-5061-7283-94a5b6c7d8e9
                    subject_user_id: b3a9b622-cc63-4d3c-aad6-2d8e29e6f9d4
                    requests:
                      - status: open
                        outstanding_required: 1
                        note: We need a couple of extra items to finish this review.
                        requested_at: '2025-06-14T10:00:00.000Z'
                        id: 1a2b3c4d-5e6f-7081-9203-a4b5c6d7e8f9
                        items:
                          - label: Certificate of incorporation
                            kind: file
                            required: true
                            responded: false
                            help: The full document, all pages.
                            key: certificate_of_incorporation
                          - label: Source of funds
                            kind: text
                            required: true
                            responded: true
                            text: Retained earnings from 2023 trading.
                            submitted_at: '2025-06-15T12:30:00.000Z'
                            key: source_of_funds
                row_count: 1
                limit: 50
                current_page: 1
                total_page_number: 1
                query_generated_time: 1712847600000
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - _AuthenticatedBearer: []
components:
  schemas:
    ListResponse_list_PlatformDocumentRequestListRead__:
      properties:
        status_code:
          type: integer
          title: Status Code
          description: HTTP status code for the response.
        data:
          items:
            $ref: '#/components/schemas/PlatformDocumentRequestListRead'
          type: array
          title: Data
          description: Payload or error details.
        query_generated_time:
          type: integer
          title: Query Generated Time
          description: >-
            UTC timestamp (milliseconds since epoch) when response was
            generated.
        row_count:
          type: integer
          minimum: 0
          title: Row Count
          description: Total rows matching the request filters (not just this page).
        limit:
          anyOf:
            - type: integer
              minimum: 1
            - type: 'null'
          title: Limit
          description: >-
            Page size used for this response. Null for cursor-paginated
            endpoints.
        current_page:
          anyOf:
            - type: integer
              minimum: 1
            - type: 'null'
          title: Current Page
          description: >-
            1-indexed page number for this response. Null for cursor-paginated
            endpoints.
        total_page_number:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
          title: Total Page Number
          description: >-
            Total number of pages given the current limit. Null for
            cursor-paginated endpoints.
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Cursor
          description: Cursor for the next page, if available.
      type: object
      required:
        - status_code
        - data
        - query_generated_time
        - row_count
      title: ListResponse[list[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

````