---
title: "Record what you decided about a screen or qualify result"
method: POST
path: "/v1/outcomes"
tags: ["qualify"]
---

# Record what you decided about a screen or qualify result

`POST /v1/outcomes`

## Request

- Base URL: `https://jid.com`
- URL: `https://jid.com/v1/outcomes`
- Auth: one of:
  - none
  - HTTP bearer

With the API key that ran the result: { result_id, outcome, note? }. Or { token } from a signed outcome link. Free. Stored without personal data for 13 months; outcomes tune the published rules.

## Request body

- object
  - `result_id` string
  - `outcome` 'legit' | 'sales_pitch' | 'spam' | 'scam' | 'closed' | 'good' | 'junk' | 'no_response': legit, sales_pitch, spam and scam on a qualification are also community reports (jid.com/privacy section 2b).
  - `note` string
  - `token` string

## Response `200`

Recorded

- object
  - `result_id` string
  - `outcome` string
  - `recorded_at` string

## Other responses

- `400`: Error
- `401`: Error
- `404`: Error
- `410`: Error

---

[API](https://skmtc.dev/jid/apis/jid-api.md) · [All operations](https://skmtc.dev/jid/apis/jid-api/llms.txt) · [OpenAPI document](https://skmtc.dev/jid/apis/jid-api/revisions/453a19ce3d5d?raw)
