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

# List Extractions

> Query and filter extraction results

## Endpoint

```
GET https://api.documind.cloud/api/v1/data/extractions
```

## Authentication

Requires `extractions:read` scope.

## Query Parameters

| Parameter        | Type              | Description                                       |
| ---------------- | ----------------- | ------------------------------------------------- |
| `skip`           | integer           | Number of items to skip (default: 0)              |
| `limit`          | integer           | Maximum items to return (default: 100, max: 1000) |
| `document_id`    | string (UUID)     | Filter by document ID                             |
| `needs_review`   | boolean           | Filter by review status                           |
| `is_reviewed`    | boolean           | Filter by reviewed state                          |
| `created_after`  | string (ISO date) | Filter by creation date                           |
| `created_before` | string (ISO date) | Filter by creation date                           |
| `sort_by`        | string            | Field to sort by (default: `created_at`)          |
| `sort_order`     | string            | Sort order: `asc` or `desc` (default: `desc`)     |

## Response

```json theme={null}
{
  "items": [
    {
      "id": "extraction-id",
      "document_id": "doc-id",
      "results": {...},
      "results_metadata": {
        "batch_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
      },
      "status": "completed",
      "needs_review": false,
      "is_reviewed": false,
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 150,
  "skip": 0,
  "limit": 100
}
```

## Examples

<CodeGroup>
  ```python Python theme={null}
  # Get extractions needing review
  response = requests.get(
      "https://api.documind.cloud/api/v1/data/extractions",
      headers={"X-API-Key": API_KEY},
      params={"needs_review": True}
  )

  # Poll for specific document
  response = requests.get(
      "https://api.documind.cloud/api/v1/data/extractions",
      headers={"X-API-Key": API_KEY},
      params={"document_id": document_id}
  )
  ```

  ```javascript Node.js theme={null}
  // Get all extractions
  const response = await axios.get(
    'https://api.documind.cloud/api/v1/data/extractions',
    {
      headers: { 'X-API-Key': API_KEY },
      params: { limit: 50 }
    }
  );
  ```
</CodeGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Extract Data" icon="brain" href="/api-reference/extract">
    Create new extractions
  </Card>

  <Card title="Batch Extract" icon="layer-group" href="/api-reference/batch-extract">
    Submit asynchronous batch extraction jobs
  </Card>

  <Card title="Understanding Reviews" icon="book" href="/api/review/understanding-reviews">
    Learn about the review workflow
  </Card>
</CardGroup>