Get request status or signed document

This article describes how to use the PDF Signing API to get the status for a specific signing request and to fetch the actual PDF document.

Get information for specific request

To get information for one specific request, use the method GET /request/{id}.

Example: Get information for specific request

Authorization: Bearer <access token>
GET /request/123?includeDocs=true

{
  "id": "123",
  "name": "Request 1",
  "description": "First request",
  "created": 1525843503909,
  "state": "IN_PROGRESS",
  "signatures": [{
    "signer" : "signer.second@example.com",
    "signed": false,
    "method": "SE_BANKID"
  }],
  "documents": [{
    {
      "name": "API.pdf",
      "data": "string"
 }]
}

Authorization: Bearer <access token>
GET /request/123?includeDocs=false

{
  "id": "123",
  "name": "Request 1",
  "description": "First request",
  "created": 1525843503909,
  "state": "IN_PROGRESS",
  "signatures": [{
    "signer" : "signer.bankid@example.com",
    "signed": false,
    "method": "SE_BANKID"
  }]
}

Get information for all requests

To get information for all requests created by the current client ID, use the method GET /request.

Example: Get information for all requests

Authorization: Bearer <access token>
GET /request

[{
  "id": "123",
  "name": "Request 1",
  "description": "First request",
  "created": 1525843503909,
  "state": "IN_PROGRESS",
  "signatures": [{
    "signer" : "signer.second@example.com",
    "signed": false,
    "method": "SE_BANKID"
  }]
}, {
  "id": "124",
  "name": "Request 2",
  "description": "Second request",
  "created": 1525843503919,
  "state": "COMPLETED",
  "signatures": [{
    "signer" : "signer.second@example.com",
    "signed": true,
    "signedAt": 1525843503929,
    "method": "PM"
  }]
  }
]