API Documentation

Integrate SigCert authentication into your applications

Overview

The SigCert API allows you to programmatically analyze signatures, access our signature database, and integrate authentication capabilities into your own applications, websites, or services.

Our RESTful API uses standard HTTP methods and returns JSON responses. All API requests require authentication via API keys, which are available to Enterprise customers.

Authentication

All API requests require an API key. Include your key in the request header:

Authorization: Bearer YOUR_API_KEY

API Endpoints

POST

/api/v1/analyze

Analyze a signature image for human-likelihood and celebrity identification.

Request:

Content-Type: multipart/form-data
Body:
  - signature: (file) Image file
  - options: (optional) JSON string with analysis options

Response:

{
  "human_likelihood_score": 85.5,
  "verdict": "More human-like",
  "celebrity_match": {
    "name": "Albert Einstein",
    "confidence": 87.3
  },
  "analysis_id": "abc123",
  "processed_image_url": "https://..."
}

GET

/api/v1/analysis/{id}

Retrieve analysis results by analysis ID.

Response:

{
  "analysis_id": "abc123",
  "status": "completed",
  "results": { ... }
}

GET

/api/v1/celebrities

List all celebrities in our signature database.

Query Parameters:

• category: Filter by category (music, film, sports, etc.)
• page: Page number (default: 1)
• limit: Results per page (default: 50)

Code Examples

cURL Example:

curl -X POST https://api.sigcert.com/v1/analyze \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "signature=@signature.jpg"

JavaScript Example:

const formData = new FormData();
formData.append('signature', fileInput.files[0]);

fetch('https://api.sigcert.com/v1/analyze', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: formData
})
.then(response => response.json())
.then(data => console.log(data));

Python Example:

import requests

url = 'https://api.sigcert.com/v1/analyze'
headers = {'Authorization': 'Bearer YOUR_API_KEY'}
files = {'signature': open('signature.jpg', 'rb')}

response = requests.post(url, headers=headers, files=files)
print(response.json())

Rate Limits

API rate limits vary by plan:

• Enterprise Basic: 1,000 requests/hour
• Enterprise Pro: 10,000 requests/hour
• Enterprise Custom: Custom limits based on agreement

Rate limit information is included in response headers:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640995200

Need API Access?

API access is available for Enterprise customers. Contact us to discuss your integration needs.

Contact Sales