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

# List parse logs

> Your parsed documents with their pages, how they were read and credits.

## Request

```bash theme={null}
curl "https://api.spidra.io/api/parse-logs?limit=20&page=1" \
  -H "Authorization: Bearer $SPIDRA_API_KEY"
```

## Response

Shortened to one log:

```json theme={null}
{
  "status": "success",
  "data": {
    "total": 16,
    "logs": [
      {
        "jobId": "60c9f3bb-f43a-4407-a86d-a45107a7c4c8",
        "status": "completed",
        "fileName": "1706.03762",
        "sourceUrl": "https://arxiv.org/pdf/1706.03762",
        "sourceType": "url",
        "format": "PDF",
        "mode": "auto",
        "pageSelection": "1",
        "totalPages": 15,
        "pagesParsed": 1,
        "ocrPages": 0,
        "hasPrompt": false,
        "creditsUsed": 1,
        "latencyMs": 555,
        "channel": "api",
        "error": null,
        "createdAt": "2026-10-25T03:23:34.000Z"
      }
    ]
  }
}
```

`jobId` opens the full result with [GET /parse/\{jobId}](https://docs.spidra.io/api-reference/parse/parse-status.md). `sourceType` is `url`, `upload` or `fileId`; `ocrPages` is how many pages were read with AI.


## OpenAPI

````yaml GET /parse-logs
openapi: 3.1.0
info:
  title: Spidra API
  version: 1.0.0
  description: >-
    Public API endpoints for web scraping via Spidra. Authenticate with
    `Authorization: Bearer YOUR_API_KEY`.
servers:
  - url: https://api.spidra.io/api
security:
  - BearerAuth: []
  - ApiKeyAuth: []
paths:
  /parse-logs:
    get:
      tags:
        - Logs
      summary: List parse logs
      description: Your parsed documents, newest first.
      parameters:
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
          description: Page number.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 10
            maximum: 100
          description: Logs per page.
      responses:
        '200':
          description: The logs.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - success
                  data:
                    type: object
                    properties:
                      logs:
                        type: array
                        items:
                          type: object
                          additionalProperties: true
                      total:
                        type: integer
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````

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