> ## Documentation Index > Fetch the complete documentation index at: https://bulkgrid.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List source documents > Required permission: sources:read. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/sources/{sourceId}/documents openapi: 3.0.3 info: title: Bulkgrid API version: 0.1.0 description: >- Search indexed content, create crawl and extraction runs, and retrieve results. API keys require the scopes listed for each operation. OAuth connections grant MCP and search access only. servers: - url: https://bulkgrid.com description: Bulkgrid security: - apiKeyAuth: [] - bearerAuth: [] tags: - name: Sources description: Source discovery, subscriptions, and indexing - name: Collections description: Collections and content selection rules - name: Search description: Search endpoints - name: Runs description: Run creation and lifecycle endpoints - name: Results description: Run result retrieval endpoints paths: /api/v1/sources/{sourceId}/documents: get: tags: - Sources summary: List source documents description: 'Required permission: sources:read.' operationId: sourcesDocuments parameters: - name: sourceId in: path required: true schema: type: string - name: parent in: query required: false schema: type: string - name: offset in: query required: false schema: type: integer minimum: 0 maximum: 9007199254740991 - name: limit in: query required: false schema: type: integer minimum: 1 maximum: 100 responses: '200': description: Successful response content: application/json: schema: type: object properties: documents: type: array items: type: object properties: id: type: string source_id: type: string url: type: string title: nullable: true type: string status_code: nullable: true type: number is_active: nullable: true type: boolean indexing_status: nullable: true type: string indexing_error: nullable: true type: string last_crawled_at: nullable: true type: string latest_content_hash: nullable: true type: string latest_version: nullable: true type: number change_count: nullable: true type: number last_changed_at: nullable: true type: string latest_crawl_result_id: nullable: true type: string last_indexed_crawl_result_id: nullable: true type: string crawl_result: nullable: true type: object properties: clean_html_size: nullable: true type: integer minimum: -9007199254740991 maximum: 9007199254740991 clean_html_url: nullable: true type: string content_hash: nullable: true type: string conversion_completed_at: nullable: true type: string conversion_error: nullable: true type: string conversion_started_at: nullable: true type: string conversion_status: nullable: true type: string conversion_time_ms: nullable: true type: integer minimum: -9007199254740991 maximum: 9007199254740991 crawled_at: nullable: true type: string created_at: type: string error_message: nullable: true type: string extract_completed_at: nullable: true type: string extract_started_at: nullable: true type: string extract_time_ms: nullable: true type: integer minimum: -9007199254740991 maximum: 9007199254740991 extraction_data: nullable: true allOf: - $ref: '#/components/schemas/Schema15___schema0' extraction_usage: nullable: true allOf: - $ref: '#/components/schemas/Schema15___schema0' file_checksum: nullable: true type: string file_mime_type: nullable: true type: string file_path: nullable: true type: string file_size: nullable: true type: integer minimum: -9007199254740991 maximum: 9007199254740991 final_url: nullable: true type: string formats_requested: nullable: true type: array items: type: string icon: nullable: true type: string icon_size: nullable: true type: integer minimum: -9007199254740991 maximum: 9007199254740991 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)$ images: nullable: true allOf: - $ref: '#/components/schemas/Schema15___schema0' indexing_completed_at: nullable: true type: string indexing_started_at: nullable: true type: string indexing_time_ms: nullable: true type: integer minimum: -9007199254740991 maximum: 9007199254740991 run_id: nullable: true type: string links: nullable: true allOf: - $ref: '#/components/schemas/Schema15___schema0' markdown_size: nullable: true type: integer minimum: -9007199254740991 maximum: 9007199254740991 markdown_url: nullable: true type: string metadata: nullable: true allOf: - $ref: '#/components/schemas/Schema15___schema0' raw_html_size: nullable: true type: integer minimum: -9007199254740991 maximum: 9007199254740991 raw_html_url: nullable: true type: string response_time_ms: nullable: true type: integer minimum: -9007199254740991 maximum: 9007199254740991 screenshot: nullable: true type: string screenshot_format: nullable: true type: string screenshot_height: nullable: true type: integer minimum: -9007199254740991 maximum: 9007199254740991 screenshot_width: nullable: true type: integer minimum: -9007199254740991 maximum: 9007199254740991 status_code: nullable: true type: integer minimum: -9007199254740991 maximum: 9007199254740991 workspace_id: nullable: true type: string title: nullable: true type: string url: type: string format: uri additionalProperties: {} last_indexed_crawl_result: nullable: true type: object properties: id: type: string indexing_completed_at: nullable: true type: string indexing_time_ms: nullable: true type: number required: - id - indexing_completed_at - indexing_time_ms additionalProperties: false required: - id - source_id - url - title - status_code - is_active - indexing_status - indexing_error - last_crawled_at - latest_content_hash - latest_version - change_count - last_changed_at - latest_crawl_result_id - last_indexed_crawl_result_id - crawl_result - last_indexed_crawl_result additionalProperties: {} total: type: number nextOffset: nullable: true type: number limit: type: number parent: type: string required: - documents - total - nextOffset - limit - parent additionalProperties: false '400': description: Bad request content: application/json: schema: type: object properties: error: type: string details: {} required: - error additionalProperties: false '401': description: Unauthorized content: application/json: schema: type: object properties: error: type: string details: {} required: - error additionalProperties: false '403': description: Forbidden content: application/json: schema: type: object properties: error: type: string details: {} required: - error additionalProperties: false '404': description: Not found content: application/json: schema: type: object properties: error: type: string details: {} required: - error additionalProperties: false '429': description: Rate limited content: application/json: schema: type: object properties: error: type: string details: {} required: - error additionalProperties: false '500': description: Internal server error content: application/json: schema: type: object properties: error: type: string details: {} required: - error additionalProperties: false security: - apiKeyAuth: [] - bearerAuth: [] components: schemas: Schema15___schema0: anyOf: - type: string nullable: true enum: - null - type: boolean - type: number - type: string - type: array items: $ref: '#/components/schemas/Schema15___schema0' - type: object additionalProperties: $ref: '#/components/schemas/Schema15___schema0' securitySchemes: apiKeyAuth: type: apiKey in: header name: x-api-key description: Bulkgrid API key bearerAuth: type: http scheme: bearer description: >- Bulkgrid API key or OAuth access token. OAuth grants currently allow search:query and mcp:use only. ````