Get Session

Retrieve full details of a specific signing session by its ID, including file information and recipient statuses.

Endpoint

GET https://api.airsign.com.au/api/v1/Session/{sessionId}

Headers

NameValueRequiredDescription
AuthorizationBearer {access_token}YesBearer token obtained from authentication

Path Parameters

ParameterTypeRequiredDescription
sessionIdstringYesThe unique identifier of the session

Example Request

curl --location 'https://api.airsign.com.au/api/v1/Session/{sessionId}' \
--header 'Authorization: Bearer {access_token}'

Response

Status: 200 OK

{
  "sessionId": "{uuid}",
  "name": "Employment Contract - John Doe",
  "status": "pending",
  "selfSignOnly": false,
  "sessionType": "offlineSigning",
  "createdAt": "2025-06-15T10:30:00.000Z",
  "updatedAt": "2025-06-15T10:30:00.000Z",
  "completedDate": null,
  "files": [
    {
      "fileId": "{uuid}",
      "fileName": "contract.pdf",
      "fileType": "application/pdf"
    }
  ],
  "recipients": [
    {
      "recipientId": "{uuid}",
      "name": "John Doe",
      "email": "[email protected]",
      "status": "pending",
      "recipientType": "toCompleteEmail",
      "signingOrder": 1
    }
  ]
}

Error Responses

StatusDescription
401Unauthorized - invalid or missing token
404Session not found or does not belong to your organisation
429Rate limit exceeded