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}/Certificate

Headers

NameValueRequiredDescription
AuthorizationBearer {access_token}YesBearer token with the read:sessions scope

Path Parameters

ParameterTypeRequiredDescription
sessionIdstringYesThe unique identifier of the session
fileIdstringSingle-document endpoint onlyThe 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

StatusDescription
401Unauthorized - invalid or missing token
404Session or file not found, or session does not belong to your organisation
409SESSION_NOT_COMPLETED - signing has not finished yet; DOCUMENT_NOT_READY - the signed PDF is still being generated, retry shortly
429Rate limit exceeded