---
title: "AARP: poll a task for its terminal state"
method: GET
path: "/access/v1/access-request/{id}"
---

# AARP: poll a task for its terminal state

`GET /access/v1/access-request/{id}`

## Request

- Base URL: `https://getsanction.com/api`
- URL: `https://getsanction.com/api/access/v1/access-request/{id}`
- Auth: API key in header `x-api-key`

Task status for an open access request (wallet-scoped: any of the wallet's agent keys). pending until the owner decides or the policy timeout settles it; approved carries result.mode 'reevaluate' and the approval object — present it back to POST /access/v1/evaluation as context.approval to redeem the one-use grant.

## Path parameters

- `id` string, required

## Response `200`

Task state (with result.approval once approved)

- AarpTaskResponse: The AARP task handle. status pending → poll status_endpoint; approved carries result.mode 'reevaluate' plus the approval object (approval.id is the one-use grant, approved_until its expiry) to present back to the evaluation endpoint as context.approval.
  - `task` object
    - `id` string
    - `status` 'pending' | 'approved' | 'denied' | 'expired'
    - `status_endpoint` string
    - `expires_at` string, date-time
    - `links` object
      - `review` string
  - `result` object
    - `mode` 'reevaluate'
    - `approval` object
      - `id` string: The one-use grant id — present as context.approval.id on re-evaluation.
      - `approved_at` string, date-time
      - `approved_until` string, date-time, nullable

## Other responses

- `401`: Invalid API key
- `404`: Unknown task (problem+json)

---

[API](https://skmtc.dev/getsanction/apis/sanction-agent-governance-api.md) · [All operations](https://skmtc.dev/getsanction/apis/sanction-agent-governance-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getsanction/apis/sanction-agent-governance-api/revisions/c645a9e4b72d?raw)