Connect the dots.
Use your account’s assessments in your own tools. All endpoints return JSON.
1. Create a key
Open API keys in your account. Use read to retrieve assessments and write to submit transcripts. Copy the key when it is shown; store it as a server-side secret.
2. Make a request
Send the key as a Bearer token. Replace the example key below with your own.
curl https://badcop.tech/api/v1/sessions/ \
-H 'Authorization: Bearer YOUR_API_KEY'
| Method and path | Permission | Result |
|---|---|---|
GET /api/v1/sessions/ | read | Your assessments, newest first. Optional page and per_page (1–100). |
GET /api/v1/sessions/{id}/ | read | Status, dates and whether findings or report content exists. |
GET /api/v1/sessions/{id}/insights/ | read | Prepared findings and summary. |
GET /api/v1/sessions/{id}/report/ | read | A prepared, unlocked report as Markdown. |
POST /api/v1/analyze/ | write | A new assessment from transcript text, with free findings and summary. |
3. Analyze a transcript
Send a JSON object with a transcript string of at least 50 characters. Share only content you are authorized to submit. Analysis is synchronous and may take a few minutes.
curl https://badcop.tech/api/v1/analyze/ \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
--data '{"transcript":"Fictional example: our five-person team deploys a Django application weekly. We need to test recovery from backups."}'
Handle the response
A successful analysis returns 201 with a session_id, insights and summary. Keep the session ID to find the assessment later. Submitting the same transcript again creates another assessment.
400: check the JSON body or query parameters.401: the key is missing, invalid or revoked.403: check the key’s permissions or the report’s purchase status.404: the assessment is unavailable to this account, or its findings/report have not been prepared.429: the key has reached its daily request limit. Check its usage in your account.503on analysis: the source is saved but analysis could not finish. Use the returned assessment link to retry without creating another assessment.
If a request times out, check your assessment list before submitting again. The server may have saved it even if you did not receive the response.