## Get a document summary by ID

`document_summaries.retrieve(strid)  -> DocumentSummary`

**get** `/document-summaries/{id}`

Retrieve a specific document summary

### Parameters

- `id: str`

### Returns

- `class DocumentSummary: …`

  - `id: str`

    Unique identifier for the document summary

  - `created_at: datetime`

    Timestamp when the summary was created

  - `display_name: str`

    Display name for the summary

  - `document_id: str`

    ID of the document this summary belongs to

  - `household_id: str`

    ID of the household this summary belongs to

  - `summary: str`

    The summary text content

  - `updated_at: datetime`

    Timestamp when the summary was last updated

  - `entry_mode: Optional[DocumentSummaryEntryMode]`

    Indicates if the summary was AI-generated or user-entered

    - `"AI_AUTO"`

    - `"USER"`

  - `summary_format: Optional[DocumentSummaryFormat]`

    Format of the summary content

    - `"MARKDOWN"`

    - `"PLAIN_TEXT"`

### Example

```python
from withluminary import Luminary

client = Luminary()
document_summary = client.document_summaries.retrieve(
    "id",
)
print(document_summary.id)
```

#### Response

```json
{
  "id": "document_summary_01ARZ3NDEKTSV4RRFFQ69G5FAV",
  "created_at": "2019-12-27T18:11:19.117Z",
  "display_name": "Default summary",
  "document_id": "document_01ARZ3NDEKTSV4RRFFQ69G5FAV",
  "household_id": "household_01ARZ3NDEKTSV4RRFFQ69G5FAV",
  "summary": "summary",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "entry_mode": "AI_AUTO",
  "summary_format": "MARKDOWN"
}
```