Get Usage Statistics
Get credit usage statistics for a given period.
Get credit usage statistics for a given period.
Authorization
bearerAuth API key as Bearer token. Format: signsecure_xxxxxxxx...
In: header
Query Parameters
Start of usage period (YYYY-MM-DD)
dateEnd of usage period (YYYY-MM-DD)
dateResponse Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.signsecure.com/api/v1/credits/usage"{
"totalUsed": 0,
"period": {
"startDate": "2019-08-24T14:15:22Z",
"endDate": "2019-08-24T14:15:22Z"
},
"breakdown": {
"document_signing": 0,
"aadhaar_esign": 0
}
}{
"code": "VALIDATION_ERROR",
"message": "startDate: Invalid date",
"requestId": "req_abc123",
"timestamp": "2026-03-11T10:30:00.000Z",
"details": {
"validation": {
"fieldErrors": {
"startDate": [
"Invalid date"
]
},
"formErrors": [],
"issues": [
{
"path": "startDate",
"message": "Invalid date",
"code": "invalid_string"
}
]
}
}
}{
"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 Credit Balance GET
Get the current credit balance. The response depends on the API key's context: - **Personal API key** — returns your personal credit balance. - **Organization API key (owner/admin)** — returns the organization wallet's spendable credits and totals. - **Organization API key (member)** — returns the member's remaining allocated credits. The `context` field in the response indicates which type of balance is being returned.
List Credit Transactions GET
List credit transaction history with pagination.