---
title: "Label a past score as fraud or legitimate"
method: POST
path: "/v1/outcome"
tags: ["Reputation"]
---

# Label a past score as fraud or legitimate

`POST /v1/outcome`

## Request

- Base URL: `https://www.layercall.com`
- URL: `https://www.layercall.com/v1/outcome`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Closes the feedback loop using the request_id from any scoring call. Free — not metered.

## Request body

- object
  - `request_id` string, required
  - `outcome` 'fraud' | 'legit', required

## Response `200`

Success

- object
  - `not_found` integer
  - `processing_time_sec` number
  - `recorded` integer
  - `request_id` string
  - `results` object[]
    - `disagreement` boolean
    - `our_score` integer
    - `our_verdict` string
    - `request_id` string
    - `status` string

## Other responses

- `400`: Invalid input
- `402`: Quota exceeded, or account paused after a failed payment
- `403`: Invalid or revoked API key
- `429`: Rate limited — honour Retry-After

---

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