# Effective entitlements of the caller

`GET /v1/me/entitlements`

The access OddsFinder derived for your credential: principal, organization, scopes,
the versions of your grants, source rights and access policy, and the dataset grants
with their competition, territory, freshness-delay and lookback limits.
It takes no query parameter: any is a `400 invalid-request`, and `known_at` or
`valid_at` a `422 unsupported-historical-capability` (the context is the current
one). The call consumes no allowance but counts towards the per-minute rate limit
like every request.

Returns `200`: Effective entitlements.
The body is [the entitlements object](obj-Entitlements.md).

Errors: `400` Malformed parameter or cursor (`invalid-request`).; `401` Missing or invalid credential (`unauthenticated`).; `403` Operation not permitted (`forbidden`) or restricted by grants/rights (`not-entitled`).; `422` Well-formed but unanswerable (`invalid-range`, `unsupported-historical-capability`).; `429` The per-minute rate limit is used up (`rate-limited`) or a daily allowance is exhausted (`quota-exceeded`). Failed requests (403, 404, other 4xx, 5xx) use up the per-minute rate limit too.; `500` Unexpected failure (`internal-error`); `request_id` identifies the server-side record.; `503` A service this operation depends on, or the access check, is temporarily unavailable (`unavailable`, `policy-unavailable`).

Example request (200 · Full grant):

```bash
curl https://api.example.com/v1/me/entitlements \
  -H "X-API-Key: $ODDSFINDER_API_KEY"
```

Example response (200):

```json
{
  "principal": {
    "type": "api_client",
    "id": "c0a80002-0000-4000-8000-000000000071"
  },
  "organization_id": "c0a80001-0000-4000-8000-000000000071",
  "scopes": [
    "read:coverage",
    "read:entities",
    "read:me",
    "read:sources"
  ],
  "grant_version": "context:1,entities:1,events:1,lineups:1,statistics:1",
  "source_rights_version": "v1",
  "policy_version": "2026-10-15.1",
  "territory": null,
  "freshness_delay_seconds": 0,
  "lookback_days": null,
  "datasets": [
    {
      "dataset": "context",
      "competition_ids": null,
      "territories": null,
      "freshness_delay_seconds": 0,
      "lookback_days": null
    },
    {
      "dataset": "entities",
      "competition_ids": null,
      "territories": null,
      "freshness_delay_seconds": 0,
      "lookback_days": null
    },
    {
      "dataset": "events",
      "competition_ids": null,
      "territories": null,
      "freshness_delay_seconds": 0,
      "lookback_days": null
    },
    {
      "dataset": "lineups",
      "competition_ids": null,
      "territories": null,
      "freshness_delay_seconds": 0,
      "lookback_days": null
    },
    {
      "dataset": "statistics",
      "competition_ids": null,
      "territories": null,
      "freshness_delay_seconds": 0,
      "lookback_days": null
    }
  ]
}
```