---
title: "Evaluate structured eligibility by immutable offer ID."
method: POST
path: "/v1/eligibility/check"
tags: ["Catalog"]
---

# Evaluate structured eligibility by immutable offer ID.

`POST /v1/eligibility/check`

## Request

- Base URL: `https://api.sourcey.com`
- URL: `https://api.sourcey.com/v1/eligibility/check`
- Auth: one of:
  - none
  - HTTP bearer

## Request body

- CheckEligibilityRequest
  - `facts` object, required
  - `offer_id` string, required

## Response `200`

Successful response.

- CheckEligibilityResponse200
  - `api_contract` 'sourcey.catalog-api/v1', required
  - `artifact_sha256` string, required
  - `data` object, required
    - `entity_id` string, required
    - `evaluation` object, required
      - `eligible` boolean, nullable, required
      - `trace` Schema0, required (unresolved $ref)
    - `lifecycle` 'active' | 'paused' | 'ended' | 'withdrawn', required
    - `offer_id` string, required
    - `program_id` string, required
    - `revision_digest` string, required
  - `release_id` string, required

## Other responses

- `400`: Invalid request.
- `401`: HTTP 401 response.
- `403`: HTTP 403 response.
- `404`: Resource not found.
- `405`: HTTP 405 response.
- `429`: HTTP 429 response.
- `500`: HTTP 500 response.
- `503`: HTTP 503 response.

---

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