---
title: Increase Requests
url: https://platform.claude.com/docs/en/api/php/beta/organization/spend_limits/increase_requests
---

# Increase Requests

## List Spend Limit Increase Requests

`$client->beta->organization->spendLimits->increaseRequests->list(?list<string> actorIDs, ?int limit, ?string page, ?list<BetaSpendLimitIncreaseRequestStatus> status): PageCursor<BetaSpendLimitIncreaseRequest>`

**GET** `/v1/organizations/spend_limit_increase_requests`

List spend limit increase requests, most recent first.

Pending requests include a live `spend_summary` for the requester.
Requests whose requester is no longer a member are excluded.

### Parameters

- `actorIDs?:optional list<string>` (query parameter)

  Filter by requester, as `user_...` tagged IDs.

- `limit?:optional int` (query parameter)

  default: 20

- `page?:optional string` (query parameter)

  Opaque cursor from a previous response's `next_page`.

- `status?:optional list<BetaSpendLimitIncreaseRequestStatus>` (query parameter)

  Filter by status. Omit to return all.

### Returns

- `class BetaSpendLimitIncreaseRequest`

  - `"spend_limit_increase_request" type`

  - `string id`

  - `Actor actor`

  - `\Datetime createdAt`

  - `SpendLimitPeriod period`

  - `?\Datetime resolvedAt`

  - `?ResolvedBy resolvedBy`

  - `?SpendSummary spendSummary`

    Per-member effective-limit report row (`GET /spend_limits/effective`).

  - `BetaSpendLimitIncreaseRequestStatus status`

### Example

```php
<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Anthropic\Client;
use Anthropic\Beta\Organization\SpendLimits\IncreaseRequests\BetaSpendLimitIncreaseRequestStatus;

$client = new Client(apiKey: 'my-anthropic-api-key');

$page = $client->beta->organization->spendLimits->increaseRequests->list(
  actorIDs: ['string'],
  limit: 1,
  page: 'page',
  status: [BetaSpendLimitIncreaseRequestStatus::APPROVED],
);

var_dump($page);
```

#### Response (200)

```json
{
  "data": [
    {
      "id": "id",
      "actor": {
        "deleted": true,
        "email_address": "email_address",
        "name": "name",
        "type": "user_actor",
        "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
      },
      "created_at": "2019-12-27T18:11:19.117Z",
      "period": "daily",
      "resolved_at": "2019-12-27T18:11:19.117Z",
      "resolved_by": {
        "deleted": true,
        "email_address": "email_address",
        "name": "name",
        "type": "user_actor",
        "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
      },
      "spend_summary": {
        "actor": {
          "deleted": true,
          "email_address": "email_address",
          "name": "name",
          "type": "user_actor",
          "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
        },
        "amount": "50000",
        "currency": "USD",
        "period": "daily",
        "period_to_date_spend": "12050.5",
        "scope": {
          "type": "user",
          "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
        },
        "source": {
          "type": "user",
          "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
        },
        "spend_limit_id": "spend_limit_id"
      },
      "status": "approved",
      "type": "spend_limit_increase_request"
    }
  ],
  "next_page": "next_page"
}
```

## Get Spend Limit Increase Request

`$client->beta->organization->spendLimits->increaseRequests->retrieve(string spendLimitIncreaseRequestID): BetaSpendLimitIncreaseRequest`

**GET** `/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}`

Retrieve a spend limit increase request.

While `pending`, the response includes a live `spend_summary` for the
requester at the request's period.

### Parameters

- `spendLimitIncreaseRequestID: string` (path parameter)

  ID of the spend limit increase request.

### Returns

- `class BetaSpendLimitIncreaseRequest`

  - `"spend_limit_increase_request" type`

  - `string id`

  - `Actor actor`

  - `\Datetime createdAt`

  - `SpendLimitPeriod period`

  - `?\Datetime resolvedAt`

  - `?ResolvedBy resolvedBy`

  - `?SpendSummary spendSummary`

    Per-member effective-limit report row (`GET /spend_limits/effective`).

  - `BetaSpendLimitIncreaseRequestStatus status`

### Example

```php
<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Anthropic\Client;

$client = new Client(apiKey: 'my-anthropic-api-key');

$betaSpendLimitIncreaseRequest = $client
  ->beta
  ->organization
  ->spendLimits
  ->increaseRequests
  ->retrieve('spend_limit_increase_request_id');

var_dump($betaSpendLimitIncreaseRequest);
```

#### Response (200)

```json
{
  "id": "id",
  "actor": {
    "deleted": true,
    "email_address": "email_address",
    "name": "name",
    "type": "user_actor",
    "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
  },
  "created_at": "2019-12-27T18:11:19.117Z",
  "period": "daily",
  "resolved_at": "2019-12-27T18:11:19.117Z",
  "resolved_by": {
    "deleted": true,
    "email_address": "email_address",
    "name": "name",
    "type": "user_actor",
    "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
  },
  "spend_summary": {
    "actor": {
      "deleted": true,
      "email_address": "email_address",
      "name": "name",
      "type": "user_actor",
      "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
    },
    "amount": "50000",
    "currency": "USD",
    "period": "daily",
    "period_to_date_spend": "12050.5",
    "scope": {
      "type": "user",
      "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
    },
    "source": {
      "type": "user",
      "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
    },
    "spend_limit_id": "spend_limit_id"
  },
  "status": "approved",
  "type": "spend_limit_increase_request"
}
```

## Approve Spend Limit Increase Request

`$client->beta->organization->spendLimits->increaseRequests->approve(string spendLimitIncreaseRequestID, string amount, ?SpendLimitPeriod period, ?bool suppressNotification): IncreaseRequestApproveResponse`

**POST** `/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/approve`

Approve a pending spend limit increase request.

Writes a per-user spend limit at `amount` for the requester and
transitions the request to `approved`. `period` defaults to the period
the member was blocked on. Anthropic emails the requester unless
`suppress_notification` is set.

### Parameters

- `spendLimitIncreaseRequestID: string` (path parameter)

  ID of the spend limit increase request.

- `amount: string`

  New per-user spend limit as a non-negative integer decimal string (minor units).

- `period?:optional SpendLimitPeriod`

- `suppressNotification?:optional bool`

### Returns

- `class IncreaseRequestApproveResponse`

  - `"spend_limit_increase_request" type`

  - `string id`

  - `Actor actor`

  - `\Datetime createdAt`

  - `SpendLimitPeriod period`

  - `?\Datetime resolvedAt`

  - `?ResolvedBy resolvedBy`

  - `SpendLimit spendLimit`

    A configured spend limit: a cap on metered spend for one scope and period.

  - `?SpendSummary spendSummary`

    Per-member effective-limit report row (`GET /spend_limits/effective`).

  - `BetaSpendLimitIncreaseRequestStatus status`

### Example

```php
<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Anthropic\Client;
use Anthropic\Beta\Organization\SpendLimits\SpendLimitPeriod;

$client = new Client(apiKey: 'my-anthropic-api-key');

$response = $client->beta->organization->spendLimits->increaseRequests->approve(
  'spend_limit_increase_request_id',
  amount: '50000',
  period: SpendLimitPeriod::MONTHLY,
  suppressNotification: true,
);

var_dump($response);
```

#### Response (200)

```json
{
  "id": "id",
  "actor": {
    "deleted": true,
    "email_address": "email_address",
    "name": "name",
    "type": "user_actor",
    "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
  },
  "created_at": "2019-12-27T18:11:19.117Z",
  "period": "daily",
  "resolved_at": "2019-12-27T18:11:19.117Z",
  "resolved_by": {
    "deleted": true,
    "email_address": "email_address",
    "name": "name",
    "type": "user_actor",
    "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
  },
  "spend_limit": {
    "id": "id",
    "amount": "50000",
    "created_at": "2019-12-27T18:11:19.117Z",
    "currency": "USD",
    "is_enabled": true,
    "period": "daily",
    "scope": {
      "type": "user",
      "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
    },
    "type": "spend_limit",
    "updated_at": "2019-12-27T18:11:19.117Z"
  },
  "spend_summary": {
    "actor": {
      "deleted": true,
      "email_address": "email_address",
      "name": "name",
      "type": "user_actor",
      "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
    },
    "amount": "50000",
    "currency": "USD",
    "period": "daily",
    "period_to_date_spend": "12050.5",
    "scope": {
      "type": "user",
      "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
    },
    "source": {
      "type": "user",
      "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
    },
    "spend_limit_id": "spend_limit_id"
  },
  "status": "approved",
  "type": "spend_limit_increase_request"
}
```

## Deny Spend Limit Increase Request

`$client->beta->organization->spendLimits->increaseRequests->deny(string spendLimitIncreaseRequestID, ?bool suppressNotification): BetaSpendLimitIncreaseRequest`

**POST** `/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/deny`

Deny a pending spend limit increase request.

Idempotent on `denied`; denying an already-`approved` request returns
400. Anthropic emails the requester unless `suppress_notification` is set.

### Parameters

- `spendLimitIncreaseRequestID: string` (path parameter)

  ID of the spend limit increase request.

- `suppressNotification?:optional bool`

### Returns

- `class BetaSpendLimitIncreaseRequest`

  - `"spend_limit_increase_request" type`

  - `string id`

  - `Actor actor`

  - `\Datetime createdAt`

  - `SpendLimitPeriod period`

  - `?\Datetime resolvedAt`

  - `?ResolvedBy resolvedBy`

  - `?SpendSummary spendSummary`

    Per-member effective-limit report row (`GET /spend_limits/effective`).

  - `BetaSpendLimitIncreaseRequestStatus status`

### Example

```php
<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Anthropic\Client;

$client = new Client(apiKey: 'my-anthropic-api-key');

$betaSpendLimitIncreaseRequest = $client
  ->beta
  ->organization
  ->spendLimits
  ->increaseRequests
  ->deny('spend_limit_increase_request_id', suppressNotification: true);

var_dump($betaSpendLimitIncreaseRequest);
```

#### Response (200)

```json
{
  "id": "id",
  "actor": {
    "deleted": true,
    "email_address": "email_address",
    "name": "name",
    "type": "user_actor",
    "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
  },
  "created_at": "2019-12-27T18:11:19.117Z",
  "period": "daily",
  "resolved_at": "2019-12-27T18:11:19.117Z",
  "resolved_by": {
    "deleted": true,
    "email_address": "email_address",
    "name": "name",
    "type": "user_actor",
    "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
  },
  "spend_summary": {
    "actor": {
      "deleted": true,
      "email_address": "email_address",
      "name": "name",
      "type": "user_actor",
      "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
    },
    "amount": "50000",
    "currency": "USD",
    "period": "daily",
    "period_to_date_spend": "12050.5",
    "scope": {
      "type": "user",
      "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
    },
    "source": {
      "type": "user",
      "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
    },
    "spend_limit_id": "spend_limit_id"
  },
  "status": "approved",
  "type": "spend_limit_increase_request"
}
```

## Domain types

### Beta Spend Limit Increase Request

- `class BetaSpendLimitIncreaseRequest`

  - `"spend_limit_increase_request" type`

  - `string id`

  - `Actor actor`

  - `\Datetime createdAt`

  - `SpendLimitPeriod period`

  - `?\Datetime resolvedAt`

  - `?ResolvedBy resolvedBy`

  - `?SpendSummary spendSummary`

    Per-member effective-limit report row (`GET /spend_limits/effective`).

  - `BetaSpendLimitIncreaseRequestStatus status`

### Beta Spend Limit Increase Request Status

- `enum BetaSpendLimitIncreaseRequestStatus`

  - `"approved"`

  - `"denied"`

  - `"pending"`