SignumFlow API Reference

Welcome to the SignumFlow API documentation. Our REST API enables you to automate document workflows, manage approvals, generate certificates, and integrate SignumFlow's powerful document processing capabilities directly into your applications.

The API is organized around REST principles with predictable resource-oriented URLs, accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

Base URL

https://api.signumflow.com

All API endpoints are relative to this base URL. API requests must be made over HTTPS.

Authentication

The SignumFlow API uses API keys to authenticate requests. You can view and manage your API keys through the Developer Portal.

To get started, create an account through the developer portal and generate your API keys. We provide two types of API keys:

  • Test API Keys (prefix: sf_test_) - Use for development and testing without affecting production data
  • Live API Keys (prefix: sf_live_) - Use in production environments

Authentication is performed via the Authorization header. Include your API key in every request:

Authorization: sf_test_YOUR_API_KEY
⚠️
Keep your API keys secure!

Do not share your API keys in publicly accessible areas such as GitHub, client-side code, or anywhere else that could expose them.

Errors

SignumFlow uses conventional HTTP response codes to indicate the success or failure of an API request. In general: codes in the 2xx range indicate success, codes in the 4xx range indicate an error that failed given the information provided, and codes in the 5xx range indicate an error with SignumFlow's servers.

200OK

Everything worked as expected

201Created

The resource was successfully created

400Bad Request

The request was invalid or cannot be served. Check the error message for details

401Unauthorized

Invalid or missing API key. Check your Authorization header

403Forbidden

The API key doesn't have permissions to perform the request

404Not Found

The requested resource doesn't exist

409Conflict

The request conflicts with another request or the current state of the resource

429Too Many Requests

You've exceeded the rate limit. Please slow down your requests

500Internal Server Error

Something went wrong on our end. Please try again later

503Service Unavailable

The service is temporarily unavailable. Please try again later

💡
Error Response Format

All errors return a JSON object with details about the error:

{ "success": false, "error": "Error message describing what went wrong" }
POST

/api/v1/upload/

Generate presigned URL for single file or batch upload with automatic virus scanning

https://api.signumflow.com/api/v1/upload/

Request Parameters

ParameterTypeRequiredDescription
file_namestringRequiredName of the file (for single file)
content_typestringRequiredMIME type (for single file)
file_sizenumberOptionalFile size in bytes
filesarrayOptionalArray of files for batch upload
workflow_idstringOptionalWorkflow to associate with upload
expires_innumberOptionalURL expiration in seconds (default: 3600)