Getting an API key

The REST API lets you generate codes, list submissions, and pull results from your own software. Available on Pro and Enterprise.

Issue a key

Go to Settings » API, click New API Key, name it (so you remember which integration it is for), and click Generate. Copy the key immediately - the full value is shown once. We store only a hash, so we cannot recover the key if you lose it.

Authentication

Pass the key as a Bearer token:

curl https://assess.pulseratalent.com/api/results \
  -H "Authorization: Bearer YOUR_API_KEY"

Endpoints

• GET /api/assessments - list your org's assessments
• POST /api/codes - generate an access code
• GET /api/codes - list codes
• GET /api/results - list submissions
• GET /api/results?id=<id> - one submission with full detail
• POST /api/webhooks - register a webhook
• GET /api/webhooks - list webhooks
• DELETE /api/webhooks?id=<id> - remove a webhook

Rate limits

120 requests per minute per key by default. Hit us with bursts; we do not penalize short spikes. Sustained over-limit requests get a 429.

Rotating a key

Generate a new key, deploy it, then revoke the old one. Revocation is immediate.