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

# List onboarding proofs

> List the onboarding proofs creators sent in one visible program, newest first. A creator sends a proof for each custom account requirement of the program (for example, a screenshot of their audience countries) and, when the program requires it, a screen recording of their warmed-up feed. `pending_review` lists only proofs that approve or reject can act on.



## OpenAPI

````yaml /api-reference/openapi.json get /onboarding/proofs
openapi: 3.0.4
info:
  title: Launchpoint Public API
  version: 1.0.0
  description: >-
    **Private preview.** The Launchpoint Public API is in private preview and
    available only to trusted partners we work with directly. Access is not
    self-serve. Email hi@launchpointhq.com to ask about access.


    REST API for Launchpoint brands and agencies. Use an API key in the
    `x-api-key` header to authenticate.


    ## Requirements

    - Public API access must be enabled for the company. During private preview,
    access is limited to trusted partners.

    - Create and manage API keys in Dashboard → Settings → Developer.


    ## Creator privacy

    - Responses never include creator email addresses. Creator phone numbers are
    null when no number is stored or the workspace does not have access to
    creator contact details.


    ## Rate limits

    - Default: **100 requests per minute** per API key.

    - Approved partner accounts: **400 requests per minute**.

    - Every response includes `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and
    `X-RateLimit-Reset`. Requests over the limit return `429`.


    ## Errors

    - Errors use `{ "error": "<message>" }` with the matching HTTP status. Some
    endpoints also include a `code`.


    ## Timestamps

    - Timestamps are Unix timestamps in milliseconds unless a field says
    otherwise.


    ## Pagination

    - Most list endpoints accept `page` and `limit` and return `{ data, page,
    total }`. Some also return `totalPages`.

    - `scope=company` is the default. A parent agency key can pass
    `scope=agency` on supported routes to include its own data and linked
    brands.
servers:
  - url: https://dashboard.launchpointhq.com/api/v1
    description: Live API server
security:
  - apiKeyAuth: []
tags:
  - name: Deals
    description: Public creator opportunities across Launchpoint
  - name: Programs
    description: Programs and campaign management
  - name: Posts
    description: Posts and social content
  - name: Analytics
    description: KPIs and performance metrics
  - name: Payouts
    description: Payouts, balances, and pending creator funds
  - name: Contracts
    description: Contracts and creator agreements
  - name: Creators
    description: Creator profiles and metrics
  - name: Applications
    description: Creator applications to Canvas programs
  - name: Messages
    description: Read and send creator messages
  - name: Onboarding
    description: 'Creator onboarding: status, messages, and proof review'
  - name: Media review
    description: >-
      Review the media creators send before they post: queue, status, approve,
      and reject
paths:
  /onboarding/proofs:
    get:
      tags:
        - Onboarding
      summary: List onboarding proofs
      description: >-
        List the onboarding proofs creators sent in one visible program, newest
        first. A creator sends a proof for each custom account requirement of
        the program (for example, a screenshot of their audience countries) and,
        when the program requires it, a screen recording of their warmed-up
        feed. `pending_review` lists only proofs that approve or reject can act
        on.
      parameters:
        - $ref: '#/components/parameters/ScopeParam'
        - in: query
          name: programId
          required: true
          schema:
            type: string
            format: uuid
        - in: query
          name: status
          schema:
            type: string
            enum:
              - pending_review
              - approved
              - rejected
            default: pending_review
        - in: query
          name: type
          schema:
            type: string
            enum:
              - account_requirement
              - warm_up
          description: Optional. Both types when absent.
        - in: query
          name: creatorId
          schema:
            type: string
          description: Optional opaque creator id
        - $ref: '#/components/parameters/CreatorHandleParam'
        - in: query
          name: page
          schema:
            type: integer
            minimum: 1
            default: 1
        - in: query
          name: limit
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
      responses:
        '200':
          description: Proofs returned successfully
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - page
                  - total
                  - totalPages
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/OnboardingProof'
                  page:
                    type: integer
                  total:
                    type: integer
                  totalPages:
                    type: integer
        '400':
          description: Invalid program, status, type, creator, or paging value
        '404':
          description: Program not found
components:
  parameters:
    ScopeParam:
      in: query
      name: scope
      required: false
      schema:
        type: string
        enum:
          - company
          - agency
        default: company
      description: >-
        Choose the data scope. `company` (default) limits results to the API key
        company's data. `agency` includes the parent agency and its linked
        brands. `scope=agency` requires a parent agency key; other keys receive
        `403`.
    CreatorHandleParam:
      in: query
      name: creatorHandle
      required: false
      schema:
        type: string
      description: >-
        Limit results to creators who have a linked social account with exactly
        this handle, in any letter case. A leading `@` is ignored. A handle that
        no visible creator linked returns an empty result. Use it when you know
        the handle but not the `creatorId`.
  schemas:
    OnboardingProof:
      type: object
      required:
        - id
        - type
        - programId
        - creatorId
        - account
        - requirement
        - media
        - status
        - rejectionComments
        - submittedAt
        - reviewedAt
      properties:
        id:
          type: string
          format: uuid
        type:
          type: string
          enum:
            - account_requirement
            - warm_up
          description: >-
            `account_requirement`: a screenshot or screen recording for a custom
            account requirement of the program. `warm_up`: a screen recording of
            the creator's warmed-up feed.
        programId:
          type: string
          format: uuid
        creatorId:
          type: string
          description: Opaque creator id, the same as in `/creators`
        account:
          type: object
          required:
            - platform
            - username
          properties:
            platform:
              type: string
              description: Platform of the creator account the proof is for
            username:
              type: string
              nullable: true
              description: Null while creator details are locked for the workspace
        requirement:
          type: object
          required:
            - id
            - label
            - instructions
            - searchTerms
          properties:
            id:
              type: string
              nullable: true
              description: Custom requirement id. Null for a warm-up proof.
            label:
              type: string
              nullable: true
              description: Requirement name. `Account warm-up` for a warm-up proof.
            instructions:
              type: string
              nullable: true
              description: >-
                What the creator was asked to show. For a warm-up proof, the
                program's warm-up instructions for the platform.
            searchTerms:
              type: array
              items:
                type: string
              description: >-
                Warm-up niches the feed should show. Empty for an account
                requirement.
        media:
          type: object
          required:
            - kind
            - mediaUrl
            - thumbnailUrl
          properties:
            kind:
              type: string
              enum:
                - image
                - video
            mediaUrl:
              type: string
              nullable: true
              description: >-
                Link that downloads the proof file. Null unless media links are
                turned on for your workspace (email hi@launchpointhq.com). The
                link does not expire; do not share it.
            thumbnailUrl:
              type: string
              nullable: true
              description: >-
                Preview image link. Null unless media links are turned on for
                your workspace.
        status:
          type: string
          enum:
            - pending_review
            - approved
            - rejected
        rejectionComments:
          type: string
          nullable: true
          description: The message the creator saw when the proof was rejected
        submittedAt:
          type: integer
          format: int64
        reviewedAt:
          type: integer
          format: int64
          nullable: true
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key created in Dashboard → Settings → Developer

````

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