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

# Get Policy

> Get an agent's policy configuration

Returns the policy (budget caps, allowed capabilities) for a specific agent.

## Path Parameters

<ParamField path="id" type="string" required>
  The agent ID (e.g., `agt_abc123`)
</ParamField>

## Response

<ResponseField name="maxPerCallUsdCents" type="number">
  Maximum cost allowed per single API call (in USD cents)
</ResponseField>

<ResponseField name="maxPerDayUsdCents" type="number">
  Maximum total spend allowed per day (in USD cents). Resets at midnight UTC.
</ResponseField>

<ResponseField name="allowedCapabilities" type="array">
  List of capabilities this agent can use. If empty or null, all capabilities are allowed.
</ResponseField>

<ResponseField name="dailySpentUsdCents" type="number">
  Amount spent today (in USD cents)
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.saturn-pay.com/v1/agents/agt_abc123/policy \
    -H "Authorization: Bearer sk_agt_..."
  ```

  ```typescript Node.js theme={null}
  const response = await fetch('https://api.saturn-pay.com/v1/agents/agt_abc123/policy', {
    headers: { 'Authorization': 'Bearer sk_agt_...' }
  });

  const policy = await response.json();
  console.log(`Daily cap: $${policy.maxPerDayUsdCents / 100}`);
  console.log(`Spent today: $${policy.dailySpentUsdCents / 100}`);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "maxPerCallUsdCents": 50,
    "maxPerDayUsdCents": 500,
    "allowedCapabilities": ["reason", "search", "read"],
    "dailySpentUsdCents": 127
  }
  ```
</ResponseExample>