---
title: "Get listing document"
method: GET
path: "/api/files/listings/{listingGuid}/documents/{documentGuid}"
tags: ["Listing Documents"]
---

# Get listing document

`GET /api/files/listings/{listingGuid}/documents/{documentGuid}`

Retrieve a single document for a listing.
**Paid feature.** Document retrieval requires an active API subscription. Returns 402 if your client is not enabled. Contact sales@skyslope.com for access.

### Validation & Requirements
#### Required Parameters
- `listingGuid` (path, string, format=guid)
- `documentGuid` (path, string, format=guid)

#### Required JSON Body Fields
- None

#### Validations
- Invalid GUID values in `*Guid`/`*Guids` fields return `422 Unprocessable Entity`.
- Invalid date values in `*date*` fields return `422 Unprocessable Entity`.
- Missing required request body returns `422 Unprocessable Entity` with `Missing request body.`.
- Additional business-rule validation may return `422` with details in the `errors` array.

## Path parameters

- `listingGuid` string, guid, required
- `documentGuid` string, guid, required

## Response `200`

- LinkedResponseOfGetListingDocumentResponse
  - `value` GetListingDocumentResponse
    - `document` Document
      - `id` string, guid
      - `name` string, nullable
      - `fileName` string, nullable
      - `extension` string, nullable
      - `fileSize` integer, nullable
      - `pages` integer, nullable
      - `documentServiceKey` string, nullable
      - `modifiedDate` string, date-time, nullable
      - `uploadDate` string, date-time, nullable
      - `url` string, nullable
      - `folder` string, nullable
  - `warnings` string[], nullable
  - `links` Link[], nullable
    - `href` string, nullable
    - `rel` string, nullable
    - `method` string, nullable

## Other responses

- `402`
- `404`

---

[API](https://skmtc.net/skyslope/apis/skyslope-api.md) · [All operations](https://skmtc.net/skyslope/apis/skyslope-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skyslope/skyslope-api/revisions/bad0d2db9b7a/schema)