Sample API requests and responses

Examples of common API interactions Below are some examples of how to use the Signit API for key tasks:

  1. Sending a signature request:
    Request:

    http
    Copy code
    POST https://api.signit.sa/documents
    Authorization: Bearer YOUR_API_KEY
    Content-Type: application/json

    {
    "title": "Contract Agreement",
    "participants": [
    {
    "name": "John Doe",
    "email": "johndoe@example.com",
    "role": "signer"
    }
    ],
    "document_url": "https://example.com/document.pdf"
    }

    Response:

    json
    Copy code
    {
    "document_id": "abc123",
    "status": "pending",
    "message": "Signature request sent successfully"
    }
  2. Checking document status:
    Request:

    http
    Copy code
    GET https://api.signit.sa/documents/abc123/status
    Authorization: Bearer YOUR_API_KEY

    Response:

    json
    Copy code
    {
    "document_id": "abc123",
    "status": "completed",
    "completed_at": "2025-01-04T12:34:56Z"
    }

Tip: Refer to the Signit API documentation for detailed endpoint descriptions and parameters.