## Get Pipeline Document Status Counts

**get** `/api/v1/pipelines/{pipeline_id}/documents/status-counts`

Count the documents in a pipeline, grouped by ingestion status.

Counts reflect each document's last recorded status rather than a freshly computed one, so a document that changed status in the last few moments may still be counted under its previous one. Use `GET /pipelines/{pipeline_id}/documents/{document_id}/status` when a single document's status has to be up to the moment.

### Path Parameters

- `pipeline_id: string`

### Query Parameters

- `data_source_id: optional string`

- `file_id: optional string`

- `only_direct_upload: optional boolean`

- `project_id: optional string`

### Cookie Parameters

- `session: optional string`

### Returns

- `counts: map[number]`

  Number of documents per ingestion status; every status is present.

- `pipeline_id: string`

  ID of the pipeline the documents belong to.

- `total_count: number`

  Total number of documents counted.

- `data_source_id: optional string`

  Data source the counts were restricted to.

- `file_id: optional string`

  File the counts were restricted to.

- `only_direct_upload: optional boolean`

  Whether only directly uploaded documents were counted.

### Example

```http
curl https://api.cloud.llamaindex.ai/api/v1/pipelines/$PIPELINE_ID/documents/status-counts \
    -H "Authorization: Bearer $LLAMA_CLOUD_API_KEY"
```

#### Response

```json
{
  "counts": {
    "foo": 0
  },
  "pipeline_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "total_count": 0,
  "data_source_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "file_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "only_direct_upload": true
}
```