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

# List Facts

> List the facts a project uses to check claims found in AI answers. Manual facts were added by a person; website facts were extracted from the project's website. Inactive facts are listed but excluded from future fact-checking. Deleted facts are never returned. Use the returned `id` as a `fact_id` in Update Facts, Delete Facts, and the `fact_ids` filter of Get Brand Perception Fact-Checking Verdicts.



## OpenAPI

````yaml https://api.peec.ai/customer/v1/openapi/json get /facts
openapi: 3.0.3
info:
  title: Peec AI Customer API
  description: Development documentation
  version: 1.0.0
  contact:
    name: Peec AI Team
    email: support@peec.ai
servers:
  - url: https://api.peec.ai/customer/v1
security: []
paths:
  /facts:
    get:
      tags:
        - Brand Perception
      summary: List Facts
      description: >-
        List the facts a project uses to check claims found in AI answers.
        Manual facts were added by a person; website facts were extracted from
        the project's website. Inactive facts are listed but excluded from
        future fact-checking. Deleted facts are never returned. Use the returned
        `id` as a `fact_id` in Update Facts, Delete Facts, and the `fact_ids`
        filter of Get Brand Perception Fact-Checking Verdicts.
      operationId: getFacts
      parameters:
        - name: project_id
          in: query
          required: false
          schema:
            description: Required if using a company api key
            example: or_f45b94ba-5e35-4982-93ed-285e72ee14eb
            type: string
        - name: origin
          in: query
          required: false
          schema:
            description: 'Only include facts added this way: manual or website.'
            type: string
            enum:
              - website
              - manual
        - name: is_active
          in: query
          required: false
          schema:
            description: >-
              Only include facts that are (true) or are not (false) used in
              future fact-checking.
            type: string
        - name: limit
          in: query
          required: false
          schema:
            default: 1000
            type: integer
            minimum: 1
            maximum: 10000
        - name: offset
          in: query
          required: false
          schema:
            default: 0
            type: integer
            minimum: 0
            maximum: 9007199254740991
      responses:
        '200':
          description: The project's facts, newest first
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          pattern: >-
                            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                          example: 0198f000-0000-7000-8000-000000000001
                        text:
                          type: string
                          example: Plans start at €99 per month.
                          description: The statement Peec checks AI claims against.
                        origin:
                          type: string
                          enum:
                            - website
                            - manual
                          example: manual
                          description: >-
                            How the fact was added: `manual` by a person,
                            `website` extracted from the project's website.
                        is_active:
                          type: boolean
                          description: >-
                            Whether Peec uses the fact in future fact-checking.
                            An inactive fact stays listed.
                        edited_at:
                          nullable: true
                          example: '2026-09-18T10:00:00.000Z'
                          description: >-
                            When the wording was last changed, or null if never
                            edited.
                          type: string
                          format: date-time
                          pattern: >-
                            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
                        created_at:
                          type: string
                          format: date-time
                          pattern: >-
                            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
                          example: '2026-09-01T10:00:00.000Z'
                      required:
                        - id
                        - text
                        - origin
                        - is_active
                        - edited_at
                        - created_at
                  total_count:
                    type: number
                  fact_limit:
                    nullable: true
                    description: >-
                      How many active facts the project's plan allows, or null
                      for unlimited.
                    type: number
                  active_fact_count:
                    type: number
                    description: >-
                      How many active facts the project holds now. Creating or
                      activating facts beyond `fact_limit` is rejected.
                required:
                  - data
                  - total_count
                  - fact_limit
                  - active_fact_count
                description: The project's facts, newest first
      security:
        - APIKeyHeader: []
        - APIKeyQuery: []
        - BearerAuth: []
components:
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
    APIKeyQuery:
      type: apiKey
      in: query
      name: api_key
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

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