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

# List media eligibility scores

> List tracked campaign posts and their current eligibility scores.

## GET /sdk/v1/campaign-media/eligibility-scores

Lists tracked campaign posts and their eligibility scores. Account-tracking
rows are not included.

All requests require `X-Application-Id` and `X-Api-Key`.

### Query parameters

* `campaignId` (optional): limit results to one campaign.
* `page` (optional): page number, starting at `1`. Default: `1`.
* `limit` (optional): posts per page. Default: `100`; maximum: `500`.

### Example request

```bash theme={null}
curl -sS "$BASE_URL/sdk/v1/campaign-media/eligibility-scores?campaignId=camp_123&page=1&limit=500" \
  -H "X-Application-Id: $APP_ID" \
  -H "X-Api-Key: $API_KEY"
```

### Response

`score` is `null` when no score has been provided yet.

```json theme={null}
{
  "success": true,
  "data": [
    {
      "campaignCreatorMediaId": "CCMEDIA_123",
      "campaignCreatorRecordId": "CCR_123",
      "campaignId": "camp_123",
      "url": "https://www.tiktok.com/@jordan/video/123",
      "platform": "TIKTOK",
      "score": 82.5
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 500,
    "total": 1,
    "totalPages": 1
  }
}
```

### Common errors

* `400`: invalid pagination or a limit greater than 500
* `401`: missing or invalid SDK credentials

Use `campaignCreatorMediaId` with
[Update media eligibility scores](/campaign-media/update-eligibility-scores).