← Developer toolsREST API

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 pathPermissionResult
GET /api/v1/sessions/readYour assessments, newest first. Optional page and per_page (1–100).
GET /api/v1/sessions/{id}/readStatus, dates and whether findings or report content exists.
GET /api/v1/sessions/{id}/insights/readPrepared findings and summary.
GET /api/v1/sessions/{id}/report/readA prepared, unlocked report as Markdown.
POST /api/v1/analyze/writeA 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.
  • 503 on 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.

AI output reflects the submitted answers. Verify findings against your own evidence before making decisions. API access does not unlock paid reports.