SignSecureSignSecure Docs
Credits

List Credit Transactions

List credit transaction history with pagination.

GET
/credits/transactions

List credit transaction history with pagination.

Authorization

bearerAuth
AuthorizationBearer <token>

API key as Bearer token. Format: signsecure_xxxxxxxx...

In: header

Query Parameters

page?integer

Page number

Default1
Range1 <= value
limit?integer

Items per page

Default50
Range1 <= value <= 100
type?string

Filter by transaction type

Value in"consume" | "add" | "refund"

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.signsecure.com/api/v1/credits/transactions"
{
  "items": [
    {
      "id": "string",
      "type": "consume",
      "amount": 0,
      "balanceAfter": 0,
      "reason": "string",
      "description": "string",
      "envelopeId": "string",
      "signatureMethod": "string",
      "source": "api",
      "createdAt": "2019-08-24T14:15:22Z"
    }
  ],
  "pageInfo": {
    "page": 0,
    "limit": 0,
    "total": 0,
    "totalPages": 0,
    "hasNext": true,
    "hasPrevious": true
  }
}
{
  "code": "VALIDATION_ERROR",
  "message": "type: Invalid enum value",
  "requestId": "req_abc123",
  "timestamp": "2026-03-11T10:30:00.000Z",
  "details": {
    "validation": {
      "fieldErrors": {
        "type": [
          "Invalid enum value"
        ]
      },
      "formErrors": [],
      "issues": [
        {
          "path": "type",
          "message": "Invalid enum value",
          "code": "invalid_enum_value"
        }
      ]
    }
  }
}
{
  "code": "UNAUTHORIZED",
  "message": "Invalid or missing API key",
  "requestId": "req_abc123",
  "timestamp": "2026-03-11T10:30:00.000Z"
}

{
  "code": "FORBIDDEN",
  "message": "API key is disabled",
  "requestId": "req_abc123",
  "timestamp": "2026-03-11T10:30:00.000Z"
}

{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "An internal error occurred",
  "requestId": "req_abc123",
  "timestamp": "2026-03-11T10:30:00.000Z"
}

Get Usage Statistics GET

Get credit usage statistics for a given period.

Create Envelope POST

Create a new envelope. Returns a presigned POST upload configuration for uploading the PDF file directly to S3. After creating the envelope, use the returned `upload.url` and `upload.fields` to upload your PDF via a multipart form `POST` to S3. S3 enforces a 10MB file size limit at upload time. **File Constraints:** - Only PDF files are supported - Max file size: 10MB (enforced by S3) **Organization Context:** If the API key was created in an organization workspace, the envelope is automatically associated with that organization and credits are deducted from the organization's wallet.