---
title: "Runs an evaluation"
method: POST
path: "/evaluations"
tags: ["Evaluations"]
---

# Runs an evaluation

`POST /evaluations`

Given a workflow specified by the header, the API will run an evaluation with the provided payload. Alloy's API is dynamic, and thus the input parameters vary depending on which services are run and how the workflow is configured.

## Headers

- `Authorization` string — Basic authorization header per the OAuth Client Authorization Header standard. The format is `Basic <auth_string>`, where `<auth_string>` is the base64 encoding of the string `token:secret` (check [Authentication Guide](https://developer.alloy.com/public/docs/authentication-guide) for details).
- `alloy-workflow-token` string — If you have migrated to the new API Key Settings page and are using account-level API keys for authentication, this header is required to specify which workflow to use for the evaluation. If you have not migrated yet, this header is optional, as the workflow will be determined by the Authorization header using workflow_token.
- `alloy-entity-token` string — If running an additional evaluation for an existing entity - the existing entity token can be provided to connect the new evaluation to the entity.
- `alloy-external-entity-id` string — A string to identify the entity created by the evaluation in your system.
- `alloy-parent-entity-token` string — A token of an entity to be used as a parent entity.
- `alloy-entity-type` 'business' | 'person' — For transactions workflows, specifies whether the entity associated with the evaluation is a `business` or `person` entity. Defaults to `person`.
- `alloy-hydrate-counterparty-data` boolean — Optional boolean value, required to be true for using counterparty sanction screening in a transaction workflow.
- `alloy-hydrate-entity-data` boolean — Optional boolean value, required to be true for using source entity sanction screening in a transaction workflow.

## Parameters

- `#/paths/~1events~1/parameters/0` — unresolved $ref

## Request body

- Schema — unresolved $ref

## Response `200`

Evaluation missing required inputs

- object
  - `status_code` string
  - `error` object
  - `timestamp` number
  - `evaluation_token` string
  - `entity_token` string
  - `application_token` string
  - `application_version_id` number
  - `required` object[] — The required fields for this workflow
    - `key` string
    - `type` string
    - `description` string
    - `regex` string
    - `properties` object
  - `optional` object[] — The optional fields for this workflow
    - `key` string
    - `type` string
    - `description` string
    - `regex` string
    - `properties` object

## Other responses

- `201` — Evaluation created

---

[API](https://skmtc.dev/alloy/apis/alloy-api.md) · [All operations](https://skmtc.dev/alloy/apis/alloy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/alloy/alloy-api/revisions/405799de4d2a/schema)