> ## 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 creator deals

> List public creator opportunities across Launchpoint for a jobs board or creator app. This catalog is platform-wide, not limited to the API key company. It includes only public, active campaigns that accept submissions and have not been deleted. Private, unlisted, paused, closed, and deleted deals are excluded.

Use each item’s `url` for the details action. It opens a public landing page before signup, with app, iPhone download, and web links. After installation or signup, a new creator must return to that page and open the deal again; automatic return through app installation is not supported.

This is not a personalized eligibility or pay feed. Launchpoint checks eligibility and shows current terms when the creator applies. The feed does not return creator identities, private budgets, or sourcing rewards.

The only query parameters are `page` and `limit`. Unsupported parameters, including `scope` and creator filters, return `400`. Results are ordered by stable deal ID. Fetch successive pages through `totalPages` to read the full catalog. Paging reads live state, so changes during a crawl can move rows between pages. Deduplicate by `id` and replace your cached catalog after each complete refresh.



## OpenAPI

````yaml /api-reference/openapi.json get /deals
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
paths:
  /deals:
    get:
      tags:
        - Deals
      summary: List creator deals
      description: >-
        List public creator opportunities across Launchpoint for a jobs board or
        creator app. This catalog is platform-wide, not limited to the API key
        company. It includes only public, active campaigns that accept
        submissions and have not been deleted. Private, unlisted, paused,
        closed, and deleted deals are excluded.


        Use each item’s `url` for the details action. It opens a public landing
        page before signup, with app, iPhone download, and web links. After
        installation or signup, a new creator must return to that page and open
        the deal again; automatic return through app installation is not
        supported.


        This is not a personalized eligibility or pay feed. Launchpoint checks
        eligibility and shows current terms when the creator applies. The feed
        does not return creator identities, private budgets, or sourcing
        rewards.


        The only query parameters are `page` and `limit`. Unsupported
        parameters, including `scope` and creator filters, return `400`. Results
        are ordered by stable deal ID. Fetch successive pages through
        `totalPages` to read the full catalog. Paging reads live state, so
        changes during a crawl can move rows between pages. Deduplicate by `id`
        and replace your cached catalog after each complete refresh.
      operationId: listCreatorDeals
      parameters:
        - in: query
          name: page
          schema:
            type: integer
            minimum: 1
            default: 1
          description: Pagination page number
        - in: query
          name: limit
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
          description: Items to return per page
      responses:
        '200':
          description: >-
            Creator deals returned successfully. An empty catalog has data: [],
            total: 0, and totalPages: 0.
          headers:
            X-RateLimit-Limit:
              description: Requests allowed per minute.
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Requests left in this window.
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Window reset time in Unix seconds.
              schema:
                type: integer
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - page
                  - total
                  - totalPages
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/CreatorDeal'
                  page:
                    type: integer
                    minimum: 1
                  total:
                    type: integer
                    minimum: 0
                  totalPages:
                    type: integer
                    minimum: 0
              example:
                data:
                  - id: 11111111-1111-4111-8111-111111111111
                    name: Daily routine videos
                    description: Create videos about your daily routine.
                    brandName: Example brand
                    brandIconUrl: null
                    url: >-
                      https://dashboard.launchpointhq.com/creator-deals/11111111-1111-4111-8111-111111111111
                    createdAt: 1788220800000
                    updatedAt: null
                page: 1
                total: 1
                totalPages: 1
        '400':
          description: Invalid pagination or unsupported query parameter.
          headers:
            X-RateLimit-Limit:
              description: Requests allowed per minute.
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Requests left in this window.
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Window reset time in Unix seconds.
              schema:
                type: integer
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
        '401':
          description: Missing, invalid, or revoked API key.
          headers:
            X-RateLimit-Limit:
              description: Requests allowed per minute.
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Requests left in this window.
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Window reset time in Unix seconds.
              schema:
                type: integer
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
        '403':
          description: API access is disabled for the workspace.
          headers:
            X-RateLimit-Limit:
              description: Requests allowed per minute.
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Requests left in this window.
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Window reset time in Unix seconds.
              schema:
                type: integer
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
        '429':
          description: >-
            API key rate limit exceeded. Retry after the Retry-After header
            value in seconds.
          headers:
            X-RateLimit-Limit:
              description: Requests allowed per minute.
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Requests left in this window.
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Window reset time in Unix seconds.
              schema:
                type: integer
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
        '500':
          description: Launchpoint could not complete the request.
          headers:
            X-RateLimit-Limit:
              description: Requests allowed per minute.
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Requests left in this window.
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Window reset time in Unix seconds.
              schema:
                type: integer
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
components:
  schemas:
    CreatorDeal:
      type: object
      required:
        - id
        - name
        - description
        - brandName
        - brandIconUrl
        - url
        - createdAt
        - updatedAt
      properties:
        id:
          type: string
          format: uuid
          description: Stable Launchpoint deal ID.
        name:
          type: string
          description: Campaign display name.
        description:
          type: string
          nullable: true
          description: >-
            Public deal description, or null when not supplied. Treat this value
            as text, not trusted HTML.
        brandName:
          type: string
          nullable: true
        brandIconUrl:
          type: string
          nullable: true
        url:
          type: string
          format: uri
          description: >-
            Public deal landing page. Show this link on your deal card. No
            Launchpoint account is needed to view it. It has links to open the
            selected deal in the app, download the iPhone app, or continue on
            web.
        createdAt:
          type: integer
          format: int64
          nullable: true
          description: Unix timestamp in milliseconds, or null when unavailable.
        updatedAt:
          type: integer
          format: int64
          nullable: true
          description: Unix timestamp in milliseconds, or null when unavailable.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key created in Dashboard → Settings → Developer

````