API Documentation

Integrate TrustCenters with your CRM, sales tools, or custom applications using our REST API.

Quick Start

Authentication

All API requests require an API key. Pass your key in the X-API-Key header.

curl -X GET "https://trustcenters.com/api/v1/documents" \
  -H "X-API-Key: your_api_key_here"

Get your API key from Settings → API Keys

Base URL

https://trustcenters.com/api/v1

Endpoints

Documents

GET/v1/documentsList all documents

POST/v1/documentsUpload a new document

GET/v1/documents/:idGet document details

DELETE/v1/documents/:idDelete a document

Portals

GET/v1/portalsList all portals

POST/v1/portalsCreate a new portal

GET/v1/portals/:idGet portal details

POST/v1/portals/:id/revokeRevoke portal access

Questionnaires

GET/questionnairesList all questionnaires

POST/questionnairesCreate a questionnaire

POST/questionnaires/:id/generateGenerate AI answers

GET/questionnaires/:id/exportExport questionnaire

Example: Create a Portal

curl -X POST "https://trustcenters.com/api/v1/portals" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "companyName": "Acme Corp",
    "contactName": "John Smith",
    "contactEmail": "john@acme.com",
    "documentIds": ["doc_123", "doc_456"],
    "requiresNda": true,
    "expiresIn": "30d"
  }'

Response

{
  "portal": {
    "id": "portal_abc123",
    "shortId": "xK9mN2p",
    "companyName": "Acme Corp",
    "status": "pending_nda",
    "createdAt": "2024-01-15T10:30:00Z"
  },
  "url": "https://trustcenters.com/p/xK9mN2p"
}

Rate Limits

Standard endpoints: 100 requests per minute
AI endpoints: 50 requests per hour
Upload endpoints: 20 requests per hour

Rate limit headers are included in all responses: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Errors

Errors return a JSON object with an error field containing message and code.

Code	Description
`400`	Bad request - invalid parameters
`401`	Unauthorized - invalid or missing API key
`403`	Forbidden - insufficient permissions
`404`	Not found - resource doesn't exist
`429`	Rate limit exceeded
`500`	Server error

OpenAPI Specification

Download the full OpenAPI 3.0 specification for use with API clients and code generators.

Download OpenAPI Spec