## Get Pipeline Document Status Counts

`$ llp pipelines:documents get-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.

### Parameters

- `--pipeline-id: string`

- `--data-source-id: optional string`

- `--file-id: optional string`

- `--only-direct-upload: optional boolean`

- `--project-id: optional string`

### Returns

- `PipelineDocumentGetStatusCountsResponse: object { counts, pipeline_id, total_count, 3 more }`

  Counts of the documents in a pipeline, grouped by ingestion status.

  - `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

```cli
llp pipelines:documents get-status-counts \
  --api-key 'My API Key' \
  --pipeline-id 182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e
```

#### 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
}
```