> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dacard.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Score enrichment

> Trigger or read the enrichment pass that pulls integration signals into a stored score.

Trigger or read the enrichment pass that pulls integration signals into a stored score. Run after connecting a new integration to fold its signals into the score's evidence chain.

## Trigger enrichment

```bash theme={null}
curl -X POST https://app.dacard.ai/api/score/scr_xyz/enrich \
  -H "Authorization: Bearer $DACARD_API_KEY"
```

## Read enrichment status

```bash theme={null}
curl -X GET https://app.dacard.ai/api/score/scr_xyz/enrichment \
  -H "Authorization: Bearer $DACARD_API_KEY"
```

| Property           | Value                       |
| ------------------ | --------------------------- |
| **Auth**           | Required                    |
| **Required scope** | Caller must own the score   |
| **Cost**           | 1 credit per enrichment run |
| **Idempotent**     | POST no. GET yes.           |

## Errors

| Status | Code               | When                           |
| ------ | ------------------ | ------------------------------ |
| 401    | `AUTH_REQUIRED`    | No session.                    |
| 402    | `CREDIT_EXHAUSTED` | No credits.                    |
| 403    | `FORBIDDEN`        | Caller does not own the score. |
| 404    | `Score not found`  | Bad `scoreId`.                 |
| 500    | `INTERNAL_ERROR`   | Enrichment or write failed.    |