Get document content
GET
/firm-partners/workspace/documents/{uuid}/contentReturns a Documents library file, base64-encoded.
Firm-private documents are never returned, and signed payroll and tax forms only to a requester COUNT would show them to. Password-protected documents return 403. Files over 10 MB return 413; use Get document download links instead.
HMAC signature only
Headers
count-workspace-iduuidrequiredUUID of the client workspace to act on. It must be one of your firm's client workspaces (or the firm's own workspace) and within the API key's client workspaces.
Path parameters
uuiduuidrequiredThe document UUID.
Responses
200The file, base64-encoded. MCP tools deliver the same file as an embedded resource instead of text.400The `count-workspace-id` header is missing.401Missing signing headers, an invalid HMAC signature, or a timestamp more than 5 minutes off. Troubleshoot403The document is password-protected, or a signed form this requester may not read. Troubleshoot404Document not found, or its file is no longer in storage.413The file is larger than 10 MB. Use Get document download links.429Rate limit exceeded (100 requests per minute per firm user of each app, or 10,000 per minute per app). TroubleshootGET
https://api.getcount.com/firm-partners/workspace/documents/{uuid}/contentRequest
import crypto from 'node:crypto';
const BASE_URL = 'https://api.getcount.com';
const CLIENT_ID = process.env.COUNT_CLIENT_ID;
const CLIENT_SECRET = process.env.COUNT_CLIENT_SECRET;
const method = 'GET';
const signingPath = '/workspace/documents/3fa85f64-5717-4562-b3fc-2c963f66afa6/content';
const timestamp = Math.floor(Date.now() / 1000).toString();
const bodyString = '';
const bodyHash = '';
const baseString = `${method}:${signingPath}:${timestamp}:${bodyHash}`;
const signature = crypto.createHmac('sha256', CLIENT_SECRET).update(baseString).digest('hex');
const response = await fetch(`${BASE_URL}/firm-partners/workspace/documents/3fa85f64-5717-4562-b3fc-2c963f66afa6/content`, {
method,
headers: {
'x-client-id': CLIENT_ID,
'x-timestamp': timestamp,
'x-signature': signature,
'count-workspace-id': '5e4d3c2b-1a09-4f8e-8d7c-6b5a49382716',
},
});
console.log(await response.json());Response · 200
{
"status": "success",
"message": "Attachment content retrieved successfully",
"data": {
"attachment": {
"id": "d9e0f1a2-b3c4-5678-def0-890123456789",
"fileName": "contract-acme-2026.pdf",
"contentType": "application/pdf",
"sizeInBytes": 70,
"contentBase64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg=="
}
}
}