---
title: "Get a list of documents related to sent offer."
method: GET
path: "/offers/{offerId}/documents"
tags: ["offers"]
---

# Get a list of documents related to sent offer.

`GET /offers/{offerId}/documents`

## Request

- Base URL: `https://api.smartrecruiters.com`
- URL: `https://api.smartrecruiters.com/offers/{offerId}/documents`
- Auth: one of:
  - API key in header `x-smarttoken`
  - OAuth 2
    - Authorization code: `https://www.smartrecruiters.com/identity/oauth/allow`
    - Token URL: `https://api.smartrecruiters.com/identity/oauth/token` scopes: `candidates_offers_read`

## Path parameters

- `offerId` string, required

## Response `200`

List of documents related to sent offer.

- OfferDocumentsList
  - `documents` OfferDocument[]
    - `id` string, uuid: Id of the document
    - `name` string: Name of the document
    - `createdDate` string, date-time: Date when the document was created Format: yyyy-MM-ddTHH:mm:ss.SSSZZ
  - `isCurrentlySyncing` boolean: Indicates if the documents are currently being synced with the provider. If true, the documents list may be subject to change.
  - `provider` 'DOCUSIGN': Name of the provider that the documents are synced with. Currently only DOCUSIGN is supported.

## Other responses

- `400`: Malformed request. ID format is invalid.
- `404`: Offer not found or lack of access to the offer.
- `409`: Offer has not been sent to the candidate.
- `422`: Offer was sent with an unsupported provider.

---

[API](https://skmtc.dev/smartrecruiters/apis/offers-api-version-1.md) - [All operations](https://skmtc.dev/smartrecruiters/apis/offers-api-version-1/llms.txt) - [OpenAPI document](https://skmtc.dev/smartrecruiters/apis/offers-api-version-1/revisions/9e94f2223496?raw)