Skip to content

  • Documentation
    • Mobile App – Signatus
    • Web App – Signatus 2 API
    • Web App – OKdokument API
    • Web App – OKdokument
  • Contact Us

1. API concept

  • Overview
  • 1.1 Supported web browsers
  • 1.2 Supported languages
  • 1.3 How to prepare document for signature
  • 1.4 How to use acrofields
  • 1.5 How to use pre-defined signature fields
  • 1.6 Document states
  • 1.7 Storing and deleting documents
  • 1.8 OKDokument API call list
  • 1.9 QR code
  • 1.10 Email and SMS
  • 1.11 Dictionary

2. Core API services

  • Authorization
  • Create signature request
  • Upload
  • Open document
  • Information about signing completion
  • Result URL
  • Download document
  • Delete document
  • Rules
  • Document fields configuration
  • Integration Resources & API Documentation

3. Additional API services

  • List of the documents
  • Document Info
  • Update Signature Request
  • Delete Signature Request
  • Signature Request Counter
  • Upload document

4. Use cases

  • Overview
  • 4.1 Example 1: Simple one-round signing
  • 4.2 Example 2: One-round signing with redirect url
  • 4.3 Example 3: One-round signing with send info
  • 4.4 Example 4: Multi-Round Signing

5. Configuration of the signing process

  • Overview
  • 5.1 One-round signing with simple PDF
  • 5.2 Multi-round signing with simple PDF
  • 5.3  One-round signing with PDF with tags
  • 5.4 Multi-round signing with PDF with tags
  • 5.5 One-round signing with PDF with signature acrofields
  • 5.6 Multi-round signing with PDF with signature acrofields
  • 5.7 Accessing document after inserting OTP
  • 5.8 Sign document with OTP
  • 5.9 Email
  • 5.10 QR code

6. Examples

  • Postman examples
View Categories
  • Home
  • Documentation
  • Web App - OKdokument API
  • 3. Additional API services
  • Document Info

Document Info

Returns a document metadata with given ID in JSON format.

Service specification:

URLhttps://apidev.okdokument.com/JSON/document/metadata/{{documentId}}
MethodGET
AuthenticationHeader x-api-key
Response Typeapplication/json

Request description #

Request parameters:

KeyTypeDescription
documentIdpathUnique document id
HTTP- Click to view HTTP code snippet
GET /JSON/document/metadata/00h2dY9Zo8KN-MXBFTX1SeJrJqTWrNwzBsFiNJEmM0OUr3Qje3tjuNyP91dyBGMlV4qFYITYqzzIlYb9b6lyI0rLZh7pWscYcJIgpGCAs6U HTTP/1.1
Host: localhost:8080
x-api-key: 7796b696_bd2b1aaf7ef4f09be9f52ce2d8d599674d81aa9d6a4421696dc4d93dd0619d682ce56b4d64a9ef097761ced99e0f67265b5f76085e5b0ee7ca4696b2ad6fe2b2

Response description #

Status codeDescription
200 OKDocument metadata
401 UnauthorizedWhen user is not authenticated
403 ForbiddenWhen user lacks required permissions
404 Not FoundIf the document with the specified id does not exist.
500 Internal Server ErrorServer processing error

Properties of the item:

filenameName of the item. (*.pdf)
idUnique identification of the document (used to send acknowledgments)
urlLink to download (for document) or to list the contents
stateState of the document: “tosign”, “signed”

Example of success response

{
	"filename": "cec00479-5669-491d-ae52-47d3b690efd7.pdf",
	"state": "tosign",
	"modification": "2022-06-21 14:30:44",
	"id": "y7Ki_u1mrUwijfb-o_S1JiphSsoXya8iypH380F",
	"date": 1655814644472,
	"number": "1655814644463"
}

Example of error response

{
    "message": "err.not.found",
    "value": "00h2dY9Zo8KN-MXBFTX1SW-ICkKkmV-1KwsfT6V_og8wPw8rOxkqPFWMOYP-17BWyLU_PVTt19HPLwkI9WF5izCdQJMD2ZBRIy0E36ToS3Y22"
}
Updated on 08/05/2026
List of the documentsUpdate Signature Request
Table of Contents
  • Request description
  • Response description
  • Documentation
    • Mobile App – Signatus
    • Web App – Signatus 2 API
    • Web App – OKdokument API
    • Web App – OKdokument
  • Contact Us
Proudly powered by WordPress