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

# List the pages of a URL source

> Returns the pages found by crawls, sorted by URL, with the knowledge base document that holds each page and the
document's state. Pages that are gone from the site, or whose document was deleted, are listed as "removed".



## OpenAPI

````yaml https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/rag/kb/{kbId}/sources/{sourceId}/pages
openapi: 3.0.4
info:
  title: Dasha BlackBox Agent API
  description: API for managing AI agents and calls
  contact:
    name: DashaAI Team
    email: support@dasha.ai
  version: v1
servers:
  - url: https://blackbox.dasha.ai
    description: Dasha BlackBox Agent API
security:
  - ApiKey: []
  - OAuth: []
tags:
  - name: ActivityLogs
  - name: Agents
  - name: AgentTestCases
  - name: AgentToolTestResults
  - name: CallResults
  - name: Calls
  - name: Chats
  - name: Copilot
  - name: CustomerData
  - name: Mcp
  - name: Media
  - name: Misc
  - name: OpsDashboard
  - name: PronunciationDictionaries
  - name: Providers
  - name: SipAliases
  - name: SipCredentials
  - name: SipDomains
  - name: SipPhoneNumbers
  - name: SipRegisterCallWebhook
  - name: TextChat
  - name: TwilioProvider
  - name: Voice
  - name: WebhookTest
  - name: WebIntegrations
  - name: WebSocket
    description: WebSocket endpoints for real-time communication
paths:
  /api/v1/rag/kb/{kbId}/sources/{sourceId}/pages:
    get:
      tags:
        - KnowledgeBaseSource
      summary: List the pages of a URL source
      description: >-
        Returns the pages found by crawls, sorted by URL, with the knowledge
        base document that holds each page and the

        document's state. Pages that are gone from the site, or whose document
        was deleted, are listed as "removed".
      parameters:
        - name: kbId
          in: path
          description: Knowledge base ID
          required: true
          schema:
            type: string
            format: uuid
        - name: sourceId
          in: path
          description: Source ID
          required: true
          schema:
            type: string
            format: uuid
        - name: skip
          in: query
          description: Optional, skip N pages. Default 0
          schema:
            maximum: 2147483647
            minimum: 0
            type: integer
            format: int32
            default: 0
        - name: take
          in: query
          description: Optional, take M pages, from 1 to 500. Default 50
          schema:
            maximum: 500
            minimum: 1
            type: integer
            format: int32
            default: 50
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/UrlSourcePageListResponse'
            application/json:
              schema:
                $ref: '#/components/schemas/UrlSourcePageListResponse'
            text/json:
              schema:
                $ref: '#/components/schemas/UrlSourcePageListResponse'
        '400':
          description: Bad Request
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ValidationProblemDetails'
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblemDetails'
            text/json:
              schema:
                $ref: '#/components/schemas/ValidationProblemDetails'
        '404':
          description: Not Found
          content:
            text/plain:
              schema: {}
            application/json:
              schema: {}
            text/json:
              schema: {}
        '500':
          description: Internal Server Error
          content:
            text/plain:
              schema: {}
            application/json:
              schema: {}
            text/json:
              schema: {}
components:
  schemas:
    UrlSourcePageListResponse:
      required:
        - items
        - total
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/UrlSourcePageInfo'
        total:
          type: integer
          format: int32
      additionalProperties: false
    ValidationProblemDetails:
      type: object
      properties:
        errors:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          nullable: true
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
      additionalProperties: {}
    UrlSourcePageInfo:
      required:
        - lastCrawledAt
        - status
        - url
      type: object
      properties:
        url:
          minLength: 1
          type: string
        title:
          type: string
          nullable: true
        documentId:
          type: string
          format: uuid
          nullable: true
        status:
          allOf:
            - $ref: '#/components/schemas/UrlSourcePageStatus'
        lastCrawledAt:
          type: string
          format: date-time
        contentHash:
          type: string
          nullable: true
      additionalProperties: false
    UrlSourcePageStatus:
      enum:
        - processing
        - indexed
        - failed
        - removed
      type: string
  securitySchemes:
    ApiKey:
      type: http
      description: API Key Authentication (Bearer {key})
      scheme: Bearer
    OAuth:
      type: oauth2
      flows:
        implicit:
          authorizationUrl: https://auth.dasha.ai/connect/authorize
          scopes:
            platform_api: Platform API

````

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