DocumentsGet document content

Get document content

GET/firm-partners/workspace/documents/{uuid}/content

Returns 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-iduuidrequired

UUID 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

uuiduuidrequired

The 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. Troubleshoot
403The document is password-protected, or a signed form this requester may not read. Troubleshoot
404Document 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). Troubleshoot
GEThttps://api.getcount.com/firm-partners/workspace/documents/{uuid}/content
Request
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=="
    }
  }
}