# Results pushed to your endpoint

`PUT` to your endpoint. Refapp sends this request to your system.

Sent to the URL pattern configured for your account, with `{projectId}` and `{candidateId}` replaced by your ids and the credential you gave us in the `Authorization` header. Sent when the candidate is created, on every state change and on completion. Answer with any 2xx.

## Body

application/json, required

- `type`, string, required: Always `"partner-results"`
- `id`, string, required
- `attributes`, object, required
  - `status`, string, required: One of `"sending"`, `"sent"`, `"pending"`, `"completed"`, `"failed"`
  - `summary`, string, required
  - `url`, string
  - `candidateLink`, object
    - `url`, string, required
    - `description`, string, required
    - `type`, string: One of `"report-url"`, `"report-pdf-data"`, `"candidate-url"`
  - `candidateSubmissionPageLink`, object
    - `url`, string, required
    - `description`, string, required
    - `type`, string: One of `"report-url"`, `"report-pdf-data"`, `"candidate-url"`
  - `assessment`, object
    - `type`, string: Always `"reference-check"`
    - `score`, number
    - `total`, number
    - `remainingToSubmit`, number
    - `completed`, number
    - `declined`, number
    - `fraudWarnings`, array of string
  - `attachments`, array of object
    - `url`, string, required
    - `description`, string, required
    - `type`, string: One of `"report-url"`, `"report-pdf-data"`, `"candidate-url"`
  - `criteria`, object: Values to route the candidate on, keyed by criterion id. `moving_criteria` in `GET /webhooks/account-integration/config` is the source of truth for the criteria and values that this account receives. This reference shows only the criteria and values that exist today. A criterion is left out until it has a value. Criteria and values can be added or removed at any time. Refapp avoids breaking changes, so a new criterion or value is more likely than a removed one or a changed value type. Ignore ids and values that you do not know.
    - `background_check_outcome`, string: Where the background check stands. `anomalies_*` once it found anomalies: pending until a reviewer approves or rejects them. `declined` when the candidate declined. More values can be added.. One of `"in_progress"`, `"clear"`, `"anomalies_pending_review"`, `"anomalies_approved"`, `"anomalies_rejected"`, `"declined"`
    - `reference_check_fraud`, string: `warning` while a fraud warning is active on the candidate. More values can be added.. One of `"positive"`, `"warning"`
    - `reference_check_referees_overdue`, string: `overdue` once the deadline for adding referees has passed and the candidate has not added all requested referees. More values can be added.. One of `"overdue"`, `"not_overdue"`
    - `reference_check_behaviours`, string: `warning` when a behavioural trait fell outside the target range, `insufficient` when too few referees answered to compare against the benchmark. More values can be added.. One of `"positive"`, `"warning"`, `"insufficient"`
    - `reference_check_cwb`, string: `warning` when a referee reported a counterproductive work behaviour. More values can be added.. One of `"positive"`, `"warning"`
    - `reference_check_recommendation`, number: How strongly the referees recommend the candidate, in percent.. `minimum: 0`. `maximum: 100`
    - `(any other key)`, string | number
  - `details`, object: Text in the account's language to show to a recruiter. The keys are names and labels, which can change. Routing rules must use `criteria`, not `details`.
    - `(any other key)`, string | object
      - `Alternative 1`, string
      - `Alternative 2`, object
        - `(any other key)`, string

### Example body

```json
{
  "type": "partner-results",
  "id": "string",
  "attributes": {
    "status": "sending",
    "summary": "string",
    "url": "string",
    "candidateLink": {
      "url": "string",
      "description": "string",
      "type": "report-url"
    },
    "candidateSubmissionPageLink": {
      "url": "string",
      "description": "string",
      "type": "report-url"
    },
    "assessment": {
      "type": "reference-check",
      "score": 0,
      "total": 0,
      "remainingToSubmit": 0,
      "completed": 0,
      "declined": 0,
      "fraudWarnings": [
        "same-ip-address"
      ]
    },
    "attachments": [
      {
        "url": "string",
        "description": "string",
        "type": "report-url"
      }
    ],
    "criteria": {
      "background_check_outcome": "in_progress",
      "reference_check_fraud": "positive",
      "reference_check_referees_overdue": "overdue",
      "reference_check_behaviours": "positive",
      "reference_check_cwb": "positive",
      "reference_check_recommendation": 0
    },
    "details": {}
  }
}
```

## What to answer

### 2XX

Received.
