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

# List recent matches

> Matches scored at or above the delivery level, newest first.



## OpenAPI

````yaml /openapi/leadfast-api-v1.json get /matches
openapi: 3.1.0
info:
  title: LeadFast API
  version: 1.0.0
  description: >-
    Read-only API for LeadFast matches, product profile and searches. The same
    core backs the MCP server.
servers:
  - url: https://leadfast.vip/api/v1
security:
  - bearerAuth: []
paths:
  /matches:
    get:
      summary: List recent matches
      description: Matches scored at or above the delivery level, newest first.
      operationId: listMatches
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
        - name: cursor
          in: query
          schema:
            type: string
          description: Value of next_cursor from the previous page.
        - name: band
          in: query
          schema:
            type: string
            enum:
              - all
              - strong
              - possible
              - research
            default: all
        - name: since
          in: query
          schema:
            type: string
            format: date-time
      responses:
        '200':
          description: A page of matches
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - next_cursor
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Match'
                  next_cursor:
                    type:
                      - string
                      - 'null'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  schemas:
    Match:
      type: object
      required:
        - id
        - subreddit
        - title
        - url
        - match_score
        - band
        - published_at
        - seen_at
      properties:
        id:
          type: string
        subreddit:
          type: string
        title:
          type: string
        excerpt:
          type: string
        url:
          type: string
          format: uri
        match_score:
          type: integer
          minimum: 0
          maximum: 100
        band:
          type: string
          enum:
            - strong
            - possible
            - research
        suggested_reply:
          type:
            - string
            - 'null'
        delivery:
          type: string
          enum:
            - sent
            - not-sent
        delivered_to:
          type: array
          items:
            type: string
        delivery_latency_seconds:
          type:
            - integer
            - 'null'
        published_at:
          type: string
          format: date-time
        seen_at:
          type: string
          format: date-time
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
            message:
              type: string
  responses:
    Unauthorized:
      description: Missing, revoked or invalid API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    RateLimited:
      description: More than 60 requests per minute for this key
      headers:
        Retry-After:
          schema:
            type: integer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: lf_...
      description: API key created in Integrations → API & agents.

````

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