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

> List chunks within a datasource using offset-based pagination. Supports filtering and sorting to locate specific segments in your knowledge base.

# List chunks with offset-based pagination



## OpenAPI

````yaml post /v2/knowledge/{knowledge_id}/datasources/{datasource_id}/chunks/list
openapi: 3.1.0
info:
  title: orq.ai API
  version: '2.0'
  description: orq.ai API documentation
servers:
  - url: https://api.orq.ai
security:
  - ApiKey: []
tags:
  - name: Guardrail Rules
  - name: Policies
  - name: Routing Rules
  - name: Files
    description: File upload and retrieval operations.
  - name: FilesService
  - name: Projects
    description: Projects organize resources within a workspace
  - name: ProjectsService
  - name: Skills
    description: >-
      Skills are modular instructions you can use to codify processes and
      conventions
  - name: SkillsService
  - name: Responses
  - description: >-
      Run agents on a cadence — cron, interval, or one-off. Minimum firing
      interval is 1 hour.
    name: Agent Schedules
  - name: Reporting
    description: >-
      GenAI reporting API over canonical analytics rollups. Accepts a metric
      name, time range, grain, group-by, and filters; returns a typed time
      series and optional totals.
  - name: ReportingService
    description: |-
      ReportingService exposes a single QueryReport RPC that maps allowlisted
       analytics payloads onto safe rollup queries. Callers never send SQL;
       the backend picks the rollup family and grain from the metric
       catalogue, the requested range, and the requested grouping.
externalDocs:
  url: https://docs.orq.ai
  description: orq.ai Documentation
paths:
  /v2/knowledge/{knowledge_id}/datasources/{datasource_id}/chunks/list:
    post:
      tags:
        - Knowledge Bases
      summary: List chunks with offset-based pagination
      operationId: ListChunksPaginated
      parameters:
        - schema:
            type: string
            description: The unique identifier of the knowledge base
          required: true
          description: The unique identifier of the knowledge base
          name: knowledge_id
          in: path
        - schema:
            type: string
            description: The unique identifier of the datasource.
          required: true
          description: The unique identifier of the datasource.
          name: datasource_id
          in: path
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                q:
                  type: string
                  default: ''
                  description: Search query to find chunks by text content
                enabled:
                  type: boolean
                  description: Filter chunks by enabled status
                status:
                  type: string
                  description: Filter chunks by processing status
                limit:
                  type: integer
                  maximum: 200
                  minimum: 1
                  default: 100
                page:
                  type: integer
                  default: 1
      responses:
        '200':
          description: Chunks successfully retrieved
          content:
            application/json:
              schema:
                type: object
                properties:
                  object:
                    type: string
                    enum:
                      - list
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        _id:
                          type: string
                          description: The unique identifier of the chunk
                        text:
                          type: string
                          description: The text content of the chunk
                        metadata:
                          type: object
                          additionalProperties:
                            anyOf:
                              - type: string
                              - type: number
                              - type: boolean
                          default: {}
                          description: >-
                            Metadata of the chunk. Can include `page_number` or
                            any other key-value pairs
                        enabled:
                          type: boolean
                          description: Whether the chunk is enabled
                        status:
                          type: string
                          enum:
                            - pending
                            - processing
                            - completed
                            - failed
                            - queued
                          description: The status of the chunk
                        created:
                          type: string
                          description: The date and time the chunk was created
                        updated:
                          type: string
                          description: The date and time the chunk was updated
                        created_by_id:
                          type:
                            - string
                            - 'null'
                          description: >-
                            The unique identifier of the user who created the
                            chunk
                        update_by_id:
                          type:
                            - string
                            - 'null'
                          description: >-
                            The unique identifier of the user who updated the
                            chunk
                      required:
                        - _id
                        - text
                        - enabled
                        - status
                        - created
                        - updated
                  has_more:
                    type: boolean
                required:
                  - object
                  - data
                  - has_more
components:
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      bearerFormat: JWT

````