Download Documents
Retrieve the final signed PDF documents and the certificate of completion of a completed session. This closes the integration loop: create a session, send it, watch its status with Get Session (or a callbackUrl), then download the signed documents here once the status is completed or completedAndGenerated.
Document downloads return short-lived pre-signed URLs (see expiresInSeconds) rather than the file bytes - fetch them promptly and do not store them. The certificate endpoint streams the PDF bytes directly, as the certificate is generated on demand.
Endpoints
GET https://api.airsign.com.au/api/v1/Session/{sessionId}/Documents
GET https://api.airsign.com.au/api/v1/Session/{sessionId}/Document/{fileId}
GET https://api.airsign.com.au/api/v1/Session/{sessionId}/CertificateHeaders
| Name | Value | Required | Description |
|---|---|---|---|
| Authorization | Bearer {access_token} | Yes | Bearer token with the read:sessions scope |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| sessionId | string | Yes | The unique identifier of the session |
| fileId | string | Single-document endpoint only | The file identifier from the session's files array (see Get Session) |
Example Request
curl --location 'https://api.airsign.com.au/api/v1/Session/{sessionId}/Documents' \
--header 'Authorization: Bearer {access_token}'Response
Status: 200 OK
{
"sessionId": "{uuid}",
"sessionStatus": "completedAndGenerated",
"documents": [
{
"fileId": "{uuid}",
"fileName": "signed-contract.pdf",
"url": "https://...pre-signed download URL..."
}
],
"expiresInSeconds": 36000
}The single-document endpoint returns the same shape for one file. The certificate endpoint responds with Content-Type: application/pdf and the certificate bytes.
Error Responses
| Status | Description |
|---|---|
| 401 | Unauthorized - invalid or missing token |
| 404 | Session or file not found, or session does not belong to your organisation |
| 409 | SESSION_NOT_COMPLETED - signing has not finished yet; DOCUMENT_NOT_READY - the signed PDF is still being generated, retry shortly |
| 429 | Rate limit exceeded |