Claude Enterprise Admin API 참고 가이드

이 가이드는 Claude Enterprise Admin API를 사용하여 Claude Enterprise 조직의 지출 한도 및 지출 한도 증가 요청을 다룹니다. 지출 한도를 통해 각 구성원의 사용 크레딧 지출을 반복되는 기간 동안 제한하고, 각 구성원의 한도가 어디서 상속되는지 확인하며, 구성원의 더 높은 한도 요청을 검토하거나 처리할 수 있습니다.

사용자별 및 시간 단위 사용량 및 비용 보고는 Analytics API 참고 가이드를 참조하세요.

Claude Enterprise Admin API는 현재 공개 베타 상태이며 사용 크레딧이 활성화된 Enterprise 플랜의 조직에서 사용할 수 있습니다.

개요

두 개의 리소스에 걸쳐 8개의 엔드포인트가 있습니다.

리소스	엔드포인트	용도
지출 한도	`GET /v1/organizations/spend_limits/effective` `GET /v1/organizations/spend_limits/{spend_limit_id}` `POST /v1/organizations/spend_limits` `DELETE /v1/organizations/spend_limits/{spend_limit_id}`	각 구성원의 유효한 한도 및 기간별 누적 지출을 읽고, 사용자별 재정의를 설정하거나 해제합니다.
지출 한도 증가 요청	`GET /v1/organizations/spend_limit_increase_requests` `GET /v1/organizations/spend_limit_increase_requests/{id}` `POST /v1/organizations/spend_limit_increase_requests/{id}/approve` `POST /v1/organizations/spend_limit_increase_requests/{id}/deny`	구성원의 더 높은 한도 요청을 나열하고 결정에 필요한 컨텍스트를 제공하며, 각 요청을 승인하거나 거부합니다.

지출 한도 엔드포인트를 사용하여 "각 구성원에게 어떤 한도가 적용되고, 어디서 나오며, 한도에 얼마나 가까운가?"라는 질문에 답하고 사용자별 재정의를 설정합니다. 지출 한도 증가 요청 엔드포인트를 사용하여 구성원이 제출한 요청 큐를 처리합니다.

필수 조건 및 인증

조직은 Claude Enterprise 플랜에 있어야 합니다.
조직에 대해 사용 크레딧이 활성화되어야 합니다. Primary Owner는 Claude의 청구 설정에서 이를 활성화할 수 있습니다.
Primary Owner는 다음 범위 중 하나 또는 둘 다를 사용하여 Admin API 키를 생성해야 합니다.
- read:spend_limits (모든 GET 엔드포인트에 필수)
- write:spend_limits (POST 및 DELETE 엔드포인트에 필수)

모든 요청의 x-api-key 헤더에 키를 전달합니다.

중요: API 키를 공개적으로 공유하거나 소스 제어에 체크인하지 마세요.

Claude Enterprise 조직을 위한 Admin API 키 생성

Primary Owner로 로그인—Claude Enterprise 상위 조직의 Primary Owner만 이러한 키를 생성할 수 있습니다.
API 설정 열기—조직 설정 > API로 이동하여 키 섹션을 찾습니다.
클릭하여 키 생성—키의 이름을 지정하고 범위 테이블에서 필요한 범위를 선택합니다. 단일 키에서 다양한 API의 범위를 결합할 수 있습니다(예: read:analytics 및 read:spend_limits).
비밀 복사 및 저장—표시된 비밀(sk-ant-api01-로 시작)을 복사하여 비밀 관리자에 저장합니다. 전체 비밀은 한 번만 표시됩니다.

기본 URL

https://api.anthropic.com

속도 제한

8개의 엔드포인트 모두는 조직당 분당 60개 요청의 단일 한도를 공유합니다. 한도를 초과하는 요청은 429 Too Many Requests를 반환합니다.

페이지 매김

GET /v1/organizations/spend_limits/effective 및 GET /v1/organizations/spend_limit_increase_requests는 불투명 커서로 페이지가 매겨집니다. 첫 번째 요청은 최대 limit개의 행과 next_page 커서를 반환합니다. 해당 커서를 변경하지 않고 다음 요청의 page 매개변수로 전달하고, next_page가 null이 될 때까지 반복합니다.

중요: 시퀀스 중간에 쿼리 매개변수를 변경하지 마세요. 커서는 이를 발급한 필터에 바인딩됩니다. user_ids[], status[] 또는 actor_ids[]를 변경하고 이전 커서를 전달하면 "cursor does not match current query parameters"라는 400 오류가 발생합니다. 대신 첫 번째 페이지에서 새 시퀀스를 시작하세요.

커서 문자열을 불투명하게 취급하세요. 직접 구문 분석, 수정 또는 구성하지 마세요.

목록 매개변수 직렬화

목록 매개변수는 대괄호 표기법을 사용합니다. 각 값에 대해 매개변수 이름을 []로 반복합니다.

user_ids[]=user_01AbCdEfGh&user_ids[]=user_01JkLmNoPq

오류 응답

상태	의미
400	잘못된 입력, 지원되지 않는 매개변수 값, 페이지 커서가 현재 매개변수와 일치하지 않음, 또는 사전 조건이 충족되지 않음(엔드포인트별 검증 참조).
401	`x-api-key` 헤더가 누락되었습니다.
403	API 키에 필요한 범위(`read:spend_limits` 또는 `write:spend_limits`)가 없습니다.
404	리소스를 찾을 수 없거나 API 키가 알려지지 않았거나, 만료되었거나, 취소되었습니다.
429	요청 제한을 초과했습니다.
500	내부 오류입니다.

오류 본문의 형식:

{"type": "error", "error": {"type": "<error_type>", "message": "..."}, "request_id": "req_..."}

error.type은 상태에 따라 달라지는 판별자입니다: invalid_request_error (400), authentication_error (401), permission_error (403), not_found_error (404), rate_limit_error (429), api_error (500). request_id는 항상 존재하며 지원팀에 문의할 때 인용할 값입니다. 각 엔드포인트 아래의 검증 테이블에 특정 메시지가 나열되어 있습니다.

개념

지출 한도 계층 구조

각 멤버의 사용 크레딧 지출은 범위 수준의 계층 구조에서 해결되는 유효 지출 한도로 제한됩니다. 멤버가 사용자별 재정의가 없으면 좌석 계층, 그룹(조직에서 그룹 기반 한도를 사용하는 경우) 또는 조직 전체 기본값으로 구성된 한도를 상속합니다.

GET /v1/organizations/spend_limits/effective를 읽으면 해결된 유효 한도, 해당 한도가 해결된 위치(source), 현재까지의 지출이 있는 모든 현재 멤버가 반환됩니다. POST /v1/organizations/spend_limits를 통해 사용자별 재정의를 설정하면 멤버가 다른 방식으로 상속할 수 있는 것과 관계없이 특정 한도로 고정됩니다. 재정의를 삭제하면 상속된 한도로 돌아갑니다.

범위

범위는 지출 한도가 작성되거나 해결되는 수준을 식별합니다:

유형	필드	의미
`user`	`user_id`	특정 멤버입니다. `user_id`는 관리자 API 사용자 엔드포인트에서 반환된 ID와 일치합니다.
`seat_tier`	`seat_tier`	좌석 계층 기본값입니다. `seat_tier` 값은 `enterprise_standard` 또는 `enterprise_tier_1`과 같은 정규화된 식별자이며, 추가 값이 추가될 수 있습니다.
`rbac_group`	`rbac_group_id`	조직에서 그룹별로 한도를 관리할 때의 그룹 기본값입니다.
`organization`	—	조직 전체 기본값입니다.

scope.type은 개방형 문자열입니다. 클라이언트는 알 수 없는 값을 불투명한 것으로 취급하고 실패하지 않고 통과해야 합니다. 향후 추가 범위 유형이 추가될 수 있습니다.

기간

period는 한도가 적용되고 지출이 재설정되는 반복 기간입니다. 현재 유일한 값은 "monthly"입니다.

period는 개방형 문자열입니다. 클라이언트는 알 수 없는 값을 불투명한 것으로 취급하고 실패하지 않고 통과해야 합니다. 향후 추가 기간 값이 추가될 수 있습니다.

금액 및 통화

모든 금전 가치는 조직의 청구 통화의 소수 단위(USD의 경우 센트)의 문자열입니다. 예를 들어 "50000"은 500.00 USD를 나타냅니다. 소수로 구문 분석하고 100으로 나누어 달러를 표시합니다. 큰 값의 경우 이진 부동 소수점을 피하십시오.

amount는 nullable입니다: null은 무제한(제한 없음)을 의미합니다. "0"은 해당 멤버에 대해 사용 크레딧이 비활성화됨을 의미합니다.

period_to_date_spend는 현재 period의 시작 이후 멤버가 발생한 사용 크레딧이며, 동일한 소수 단위 형식입니다. 소수 부분을 포함할 수 있습니다(예: "41280.125").

지출 한도 증가 요청 수명 주기

지출 한도 증가 요청은 멤버가 claude.ai에서 "더 많은 사용 요청"을 클릭할 때 생성됩니다. 요청은 이 API를 통해 생성되지 않습니다.

상태	의미
`pending`	관리자 조치를 기다리는 중입니다. 요청은 일반적으로 라이브 `spend_summary`를 포함하므로 결정할 때 멤버의 현재 유효 한도 및 현재까지의 지출을 볼 수 있습니다. `spend_summary`를 계산할 수 없으면 `null`일 수 있으므로 해당 경우를 처리하십시오.
`approved`	요청이 승인으로 해결되었습니다: 관리자가 명시적으로 승인했거나(관리자가 제공한 금액으로 사용자별 지출 한도 작성), 다른 관리자 조치가 멤버에게 사용 크레딧을 사용 가능하게 했거나(예: 좌석 계층 한도 인상 또는 조직에 대한 사용 크레딧 청구 활성화), Anthropic 지원이 조직을 대신하여 한도를 인상했습니다. `spend_summary`는 `null`입니다.
`denied`	관리자가 거부했습니다. `spend_summary`는 `null`입니다. Claude.ai는 `resolved_at`부터 30일 동안 해당 멤버의 요청 버튼을 숨깁니다. 관리자는 언제든지 멤버의 한도를 직접 올릴 수 있습니다.

approved와 denied 모두 최종 상태입니다. 멤버는 한 번에 최대 하나의 pending 요청을 가질 수 있습니다.

POST …/approve를 통해 승인하면 POST /v1/organizations/spend_limits가 작성하는 것과 동일한 사용자별 지출 한도 행을 작성합니다. 지출 한도를 직접 설정하면 보류 중인 요청이 전환되지 않습니다. 요청을 해결하려면 승인 엔드포인트를 사용하세요.

기본적으로 Anthropic은 멤버의 요청이 승인되거나 거부될 때 멤버에게 이메일을 보냅니다. 승인 또는 거부 시 suppress_notification: true를 전달하여 해당 이메일을 억제할 수 있습니다(예: 자신의 시스템이 멤버에게 알릴 때).

SpendLimit 객체

한 범위 수준에서 구성된 한도입니다.

{
  "type": "spend_limit",
  "id": "spl_01AbCdEfGhIjKlMnOpQrSt",
  "created_at": "2026-05-01T12:00:00Z",
  "updated_at": "2026-05-03T09:14:11Z",
  "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
  "amount": "50000",
  "currency": "USD",
  "period": "monthly"
}

필드	유형	설명
`type`	문자열	항상 `"spend_limit"`입니다.
`id`	문자열	`spl_` 접두사가 붙습니다.
`created_at`	문자열(RFC 3339)	이 한도가 처음 설정된 시간입니다.
`updated_at`	문자열(RFC 3339)	이 한도가 마지막으로 변경된 시간입니다.
`scope`	범위	이 한도가 작성된 수준입니다. "범위" 섹션을 참조하세요.
`amount`	문자열 또는 null	`period`에 대한 한도(최소 단위)입니다. `null`은 무제한을 의미합니다.
`currency`	문자열	ISO 4217. 조직의 청구 통화입니다.
`period`	문자열	`amount`가 적용되는 반복 기간입니다. "기간" 섹션을 참조하세요.

SpendSummary 객체

계산된 멤버별 보고서 행: 멤버의 유효 한도, 출처, 기간별 지출입니다. 주소 지정 가능한 리소스가 아닙니다(id 없음).

{
  "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
  "amount": "50000",
  "currency": "USD",
  "period": "monthly",
  "source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
  "spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
  "period_to_date_spend": "31402.5"
}

필드	유형	설명
`scope`	범위(`type: "user"`)	이 행이 해당하는 멤버입니다.
`amount`	문자열 또는 null	`period`에 대한 유효 한도(최소 단위)입니다. `null`은 무제한을 의미하고, `"0"`은 사용 크레딧이 비활성화됨을 의미합니다.
`currency`	문자열	ISO 4217.
`period`	문자열	`source`가 해결된 지출 한도의 기간입니다. "기간" 섹션을 참조하세요.
`source`	범위	`amount`가 계층 구조에서 해결된 위치입니다. 멤버가 사용자별 재정의를 가지고 있을 때 `scope`와 같습니다.
`spend_limit_id`	문자열	`source`가 해결된 `SpendLimit`의 ID입니다. `GET /v1/organizations/spend_limits/{spend_limit_id}`로 가져옵니다.
`period_to_date_spend`	문자열	현재 `period` 시작 이후 멤버가 적립한 사용 크레딧(소수 단위).

SpendLimitIncreaseRequest 객체

{
  "type": "spend_limit_increase_request",
  "id": "slir_01AbCdEfGhIjKlMnOpQrSt",
  "created_at": "2026-05-04T16:22:09Z",
  "status": "pending",
  "resolved_at": null,
  "resolved_by": null,
  "actor": {
    "type": "user_actor",
    "user_id": "user_01AbCdEfGh",
    "name": "Jane Smith",
    "email_address": "[email protected]"
  },
  "spend_summary": {
    "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
    "amount": "50000",
    "currency": "USD",
    "period": "monthly",
    "source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
    "spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
    "period_to_date_spend": "48900"
  }
}

필드	유형	설명
`type`	문자열	항상 `"spend_limit_increase_request"`입니다.
`id`	문자열	`slir_` 접두사가 붙습니다.
`created_at`	문자열 (RFC 3339)	멤버가 요청을 제출한 시간입니다.
`status`	문자열	`pending`, `approved`, 또는 `denied`.
`resolved_at`	문자열 (RFC 3339) 또는 null	요청이 승인되거나 거부된 시간입니다. 대기 중일 때는 `null`입니다.
`resolved_by`	Actor 또는 null	요청을 승인하거나 거부한 사람입니다: `user_actor`(관리자가 claude.ai에서 작동) 또는 `scoped_api_key_actor`(이 API를 통해 해결됨). 관리자가 claude.ai에서 작업을 통해 요청을 자동으로 해결할 때(예: 시트 계층 제한 상향, 조직에 대한 사용 크레딧 청구 활성화 또는 멤버의 제한 상향), `resolved_by`는 작동하는 관리자의 `user_actor`입니다. 대기 중일 때, 해결하는 관리자의 계정이 삭제되었을 때, 또는 요청이 Anthropic 지원에 의해 해결되었을 때 `null`입니다. `scoped_api_key_actor`는 이후 삭제되거나 취소된 키를 참조할 수 있습니다. `scoped_api_key_id`를 역사적 참조로 취급하고 조회 실패를 허용합니다.
`actor`	Actor (`user_actor`)	요청을 제출한 멤버입니다.
`spend_summary`	SpendSummary 또는 null	요청자의 실시간 의사결정 컨텍스트: 유효한 제한 및 기간별 지출. `status`가 대기 중일 때 표시됨(요약을 계산할 수 없으면 `null`일 수 있음); 해결되면 항상 `null`입니다.

Actor

필드	유형	설명
`type`	문자열	`user_actor` 또는 `scoped_api_key_actor`.
`user_id`	문자열	`user_actor`에 표시됩니다. 사용자의 ID; `actor_ids[]`에서 허용하는 동일한 값입니다.
`name`	문자열 또는 null	`user_actor`에 표시됩니다. 사용자의 이름; 계정이 삭제되었거나 사용자가 이름을 설정하지 않은 경우 `null`입니다.
`email_address`	문자열 또는 null	`user_actor`에 표시됩니다. 사용자의 이메일입니다. 계정이 삭제된 경우 `null`입니다.
`scoped_api_key_id`	문자열	`scoped_api_key_actor`에 표시됩니다. `apikey_` 접두사가 붙습니다.

지출 한도

1. 유효한 지출 한도 나열

GET /v1/organizations/spend_limits/effective

해결된 유효 한도 및 기간별 지출이 포함된 조직의 현재 모든 구성원을 반환합니다. 사용자별 재정의가 없는 구성원은 source.type이 seat_tier, rbac_group 또는 organization으로 표시됩니다. 이전 구성원은 나열되지 않습니다.

필요한 범위: read:spend_limits.

쿼리 매개변수

필드	유형	필수	기본값	설명
`user_ids[]`	문자열, 최대 100개 항목	아니요	모든 구성원	특정 구성원으로 범위를 좁힙니다. `user_...` ID를 허용합니다. 현재 구성원이 아닌 항목은 `data`에서 자동으로 생략됩니다.
`limit`	정수 1–1000	아니요	20	페이지당 행 수입니다.
`page`	불투명 커서 문자열	아니요	—	이전 응답의 `next_page` 값입니다.

응답 필드

필드	유형	설명
`data`	SpendSummary 배열	구성원당 하나의 항목으로, 구성원이 조직에 가입한 시간 순서대로 정렬됩니다(최신순).
`next_page`	문자열 또는 null	다음 페이지의 불투명 커서입니다. 더 이상 페이지가 없으면 `null`입니다.

요청 예시

curl "https://api.anthropic.com/v1/organizations/spend_limits/effective?limit=20" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

응답 예시

{
  "data": [
    {
      "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
      "amount": "50000",
      "currency": "USD",
      "period": "monthly",
      "source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
      "spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
      "period_to_date_spend": "31402.5"
    }
  ],
  "next_page": "page_..."
}

유효성 검사

조건	상태	메시지
`user_ids[]` 항목 형식 오류	400	`user_ids[]: entry is not a valid user ID`
`user_ids[]`에 100개 이상의 항목이 있습니다	400
`limit`이(가) 1–1000 범위를 벗어났습니다	400
`page` 커서가 유효하지 않습니다	400	`page: invalid cursor`
`page` 커서가 현재 `user_ids[]`와 일치하지 않습니다	400	`page: cursor does not match current query parameters`
다른 API 버전의 `page` 커서입니다	400	`page: cursor was issued by a different API version`
조직이 Enterprise 요금제에 없습니다	400	`this endpoint is not supported for this organization type`
사용 크레딧 청구가 활성화되지 않았습니다	400	`overage billing is not enabled for this organization`

2. 지출 한도 가져오기

GET /v1/organizations/spend_limits/{spend_limit_id}

ID로 단일 지출 한도를 반환합니다. 이를 사용하여 SpendSummary.spend_limit_id 또는 POST 응답이 참조한 행을 검사합니다.

필수 범위: read:spend_limits.

경로 매개변수

필드	유형	설명
`spend_limit_id`	문자열	`spl_` 접두사가 붙습니다.

응답

SpendLimit 객체입니다.

요청 예시

curl "https://api.anthropic.com/v1/organizations/spend_limits/spl_01AbCdEfGhIjKlMnOpQrSt" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

유효성 검사

조건	상태	메시지
`spend_limit_id`을(를) 이 조직에서 찾을 수 없습니다	404
조직이 Enterprise 요금제에 없습니다	400	`this endpoint is not supported for this organization type`
사용 크레딧 청구가 활성화되지 않았습니다	400	`overage billing is not enabled for this organization`

3. 지출 한도 설정

POST /v1/organizations/spend_limits

사용자별 지출 한도 재정의를 설정합니다. Upsert: 이미 한도가 있는 사용자에 대해 한도를 설정하면 기존 한도를 덮어씁니다.

scope.type: "user"만 허용됩니다. 시트 계층, 그룹 및 조직 수준 기본값은 claude.ai 설정에서 구성됩니다.

지출 한도를 직접 설정하면 구성원의 보류 중인 증가 요청이 전환되지 않습니다. 요청을 해결하려면 승인 엔드포인트를 사용하세요.

필수 범위: write:spend_limits.

요청 본문

필드	유형	필수	설명
`scope`	객체	예	`{ "type": "user", "user_id": "user_..." }`.
`amount`	문자열 또는 null	예	`period`의 새로운 한도(소수 단위, 음이 아닌 정수 십진 문자열). `"0"`은 회원의 사용 크레딧을 비활성화합니다. `null`은 한도를 제거합니다(무제한).
`period`	문자열	아니오	기본값 `"monthly"`. "Period" 섹션을 참조하세요.

응답

작성된 재정의를 반영하는 SpendLimit 객체입니다.

요청 예시

curl -X POST "https://api.anthropic.com/v1/organizations/spend_limits" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "content-type: application/json" \
  -d '{"scope": {"type": "user", "user_id": "user_01AbCdEfGh"}, "amount": "75000"}'

응답 예시

{
  "type": "spend_limit",
  "id": "spl_01RsTuVwXyZaBcDeFgHiJk",
  "created_at": "2026-05-11T10:02:44Z",
  "updated_at": "2026-05-11T10:02:44Z",
  "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
  "amount": "75000",
  "currency": "USD",
  "period": "monthly"
}

검증

조건	상태	메시지
`scope.type`이 `"user"`가 아님	400	`scope.type: 아직 지원되지 않음`
`scope.user_id` 형식 오류	400	`scope.user_id: 형식 오류`
`scope.user_id`가 이 조직의 회원이 아님	400	`scope.user_id: 이 조직의 회원이 아님`
`amount`가 음수, 소수 또는 유효한 십진 문자열이 아님	400
`period`가 `"monthly"`가 아님	400	`period: 아직 지원되지 않음`
조직이 Enterprise 요금제에 없음	400	`이 엔드포인트는 이 조직 유형에서 지원되지 않음`
사용 크레딧 청구가 활성화되지 않음	400	`이 조직에 대해 초과 청구가 활성화되지 않음`

4. 지출 한도 제거

DELETE /v1/organizations/spend_limits/{spend_limit_id}

사용자별 재정의를 제거하여 회원이 상속된 한도(좌석 계층, 그룹 또는 조직 기본값)로 돌아갑니다. 좌석 계층, 그룹 및 조직 수준 행은 이 엔드포인트를 통해 삭제할 수 없습니다.

필요한 범위: write:spend_limits.

경로 매개변수

필드	유형	설명
`spend_limit_id`	문자열	접두사 `spl_`. 사용자별 재정의의 ID여야 합니다.

응답

{ "type": "spend_limit_deleted", "id": "spl_01RsTuVwXyZaBcDeFgHiJk" }

요청 예시

curl -X DELETE "https://api.anthropic.com/v1/organizations/spend_limits/spl_01RsTuVwXyZaBcDeFgHiJk" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

유효성 검사

조건	상태	메시지
이 조직에서 `spend_limit_id`를 찾을 수 없습니다	404
`spend_limit_id`는 시트 계층, 그룹 또는 조직 행입니다	400	`이 엔드포인트를 통해서는 사용자별 지출 한도만 삭제할 수 있습니다.`
조직이 Enterprise 요금제에 없습니다	400	`이 엔드포인트는 이 조직 유형에서 지원되지 않습니다`
사용 크레딧 청구가 활성화되지 않음	400	`이 조직에 대해 초과 청구가 활성화되지 않았습니다`

지출 한도 증가 요청

5. 증가 요청 나열

GET /v1/organizations/spend_limit_increase_requests

증가 요청을 최신순으로 나열합니다. 요청자가 더 이상 조직의 구성원이 아닌 요청은 제외됩니다.

필요한 범위: read:spend_limits.

쿼리 매개변수

필드	유형	필수	기본값	설명
`status[]`	`pending`, `approved`, `denied` 중 하나 이상	아니오	모두	상태별로 필터링합니다. 여러 값의 경우 매개변수를 반복합니다.
`actor_ids[]`	문자열	아니오	모두	요청자별로 필터링합니다. `user_...` ID를 허용합니다.
`limit`	정수 1–1000	아니오	20	페이지당 행 수입니다.
`page`	불투명 커서 문자열	아니오	—	이전 응답의 `next_page` 값입니다.

응답 필드

필드	유형	설명
`data`	SpendLimitIncreaseRequest 배열	`created_at` 내림차순으로 정렬됩니다.
`next_page`	문자열 또는 null	다음 페이지의 불투명 커서입니다. 페이지가 더 이상 없으면 `null`입니다.

요청 예시

curl "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests?status[]=pending&limit=50" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

응답 예시

{
  "data": [
    {
      "type": "spend_limit_increase_request",
      "id": "slir_01AbCdEfGhIjKlMnOpQrSt",
      "created_at": "2026-05-04T16:22:09Z",
      "status": "pending",
      "resolved_at": null,
      "resolved_by": null,
      "actor": {
        "type": "user_actor",
        "user_id": "user_01AbCdEfGh",
        "name": "Jane Smith",
        "email_address": "[email protected]"
      },
      "spend_summary": {
        "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
        "amount": "50000",
        "currency": "USD",
        "period": "monthly",
        "source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
        "spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
        "period_to_date_spend": "48900"
      }
    }
  ],
  "next_page": null
}

유효성 검사

조건	상태	메시지
`actor_ids[]` 항목 형식 오류	400	`actor_ids[]: 잘못된 태그된 사용자 ID`
`limit` 범위 1–1000 초과	400
`page` 커서 형식 오류	400	`잘못된 페이지 커서 형식` 또는 `잘못된 페이지 커서`
`page` 커서가 현재 `status[]` 또는 `actor_ids[]`와 일치하지 않음	400	`페이지 커서가 현재 쿼리 매개변수와 일치하지 않음`
다른 API 버전의 `page` 커서	400	`페이지 커서는 다른 API 버전에서 발급되었습니다. 페이지 매김을 다시 시작하세요`
조직이 Enterprise 요금제에 없음	400	`이 엔드포인트는 이 조직 유형에서 지원되지 않습니다`
사용 크레딧 청구 미활성화	400	`이 조직에 대해 초과 청구가 활성화되지 않았습니다`

6. 증액 요청 조회

GET /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}

단일 증액 요청을 반환합니다.

필수 범위: read:spend_limits.

경로 매개변수

필드	유형	설명
`spend_limit_increase_request_id`	문자열	`slir_` 접두사가 붙습니다.

응답

SpendLimitIncreaseRequest 객체입니다.

요청 예시

curl "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

검증

조건	상태	메시지
이 조직에서 요청을 찾을 수 없습니다	404
요청자가 더 이상 이 조직의 구성원이 아닙니다	404
조직이 Enterprise 요금제에 가입되어 있지 않습니다	400	`이 엔드포인트는 이 조직 유형에서 지원되지 않습니다`
사용량 크레딧 청구가 활성화되지 않았습니다	400	`이 조직에 대해 초과 청구가 활성화되지 않았습니다`

7. 증액 요청 승인

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

대기 중인 요청을 승인합니다. amount에서 요청자에 대한 사용자당 지출 한도를 작성하고 요청을 approved로 전환합니다. 요청에 요청된 금액이 없으면 관리자가 승인 시 새 한도를 제공합니다.

필수 범위: write:spend_limits.

경로 매개변수

필드	유형	설명
`spend_limit_increase_request_id`	문자열	`slir_` 접두사가 붙습니다.

요청 본문

필드	유형	필수	기본값	설명
`amount`	문자열	예	—	`period`에 대한 새로운 사용자당 한도(소수 단위, 음이 아닌 정수 십진 문자열)
`period`	문자열	아니요	`"monthly"`	"Period" 섹션을 참조하세요.
`suppress_notification`	부울	아니요	`false`	`true`인 경우 Anthropic은 요청이 승인되었음을 구성원에게 이메일로 보내지 않습니다.

응답

상태가 approved인 SpendLimitIncreaseRequest이며, 작성된 SpendLimit을 포함하는 추가 spend_limit 필드가 있습니다.

요청 예시

curl -X POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/approve" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "content-type: application/json" \
  -d '{"amount": "75000", "suppress_notification": true}'

응답 예시

{
  "type": "spend_limit_increase_request",
  "id": "slir_01AbCdEfGhIjKlMnOpQrSt",
  "created_at": "2026-05-04T16:22:09Z",
  "status": "approved",
  "resolved_at": "2026-05-11T10:05:02Z",
  "resolved_by": {
    "type": "scoped_api_key_actor",
    "scoped_api_key_id": "apikey_01ZyXwVuTsRqPoNmLkJiHg"
  },
  "actor": {
    "type": "user_actor",
    "user_id": "user_01AbCdEfGh",
    "name": "Jane Smith",
    "email_address": "[email protected]"
  },
  "spend_summary": null,
  "spend_limit": {
    "type": "spend_limit",
    "id": "spl_01RsTuVwXyZaBcDeFgHiJk",
    "created_at": "2026-05-11T10:05:02Z",
    "updated_at": "2026-05-11T10:05:02Z",
    "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
    "amount": "75000",
    "currency": "USD",
    "period": "monthly"
  }
}

검증

조건	상태	메시지
이 조직에서 요청을 찾을 수 없습니다	404
요청자가 더 이상 이 조직의 구성원이 아닙니다	404
요청이 이미 `승인됨` 또는 `거부됨`	400	`지출 한도 증가 요청이 이미 해결됨`
`금액`이 음수, 소수, 또는 유효한 십진수 문자열이 아님	400
`기간`이 `"월간"`이 아님	400	`기간: 아직 지원되지 않음`
조직이 Enterprise 요금제에 없습니다	400	`이 엔드포인트는 이 조직 유형에서 지원되지 않습니다`
사용 크레딧 청구가 활성화되지 않음	400	`이 조직에 대해 초과 청구가 활성화되지 않음`

8. 증가 요청 거부

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

보류 중인 요청을 거부합니다. 거부됨에서 멱등성: 이미 거부된 요청을 거부하면 기존 리소스와 함께 200을 반환합니다. 이미 승인된 요청을 거부하는 것은 거부되므로 자동화가 재시도를 충돌하는 결정과 구별할 수 있습니다.

필요한 범위: write:spend_limits.

경로 매개변수

필드	유형	설명
`spend_limit_increase_request_id`	문자열	`slir_` 접두사가 붙음.

요청 본문

필드	유형	필수	기본값	설명
`suppress_notification`	부울	아니요	`거짓`	`참`이면 Anthropic은 요청이 거부되었다는 이메일을 구성원에게 보내지 않습니다.

응답

거부됨 상태의 SpendLimitIncreaseRequest.

요청 예시

curl -X POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/deny" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "content-type: application/json" \
  -d '{"suppress_notification": true}'

검증

조건	상태	메시지
이 조직에서 요청을 찾을 수 없습니다	404
요청자가 더 이상 이 조직의 구성원이 아닙니다	404
요청이 이미 `승인됨`	400	`지출 한도 증가 요청이 이미 승인됨`
요청이 이미 `거부됨`	— (200, idempotent)
조직이 Enterprise 요금제에 없습니다	400	`이 엔드포인트는 이 조직 유형에서 지원되지 않습니다`
사용 크레딧이 활성화되지 않음	400	`이 조직에 대해 초과 요금 청구가 활성화되지 않았습니다`