Panduan referensi Claude Enterprise Admin API

Panduan ini mencakup batas pengeluaran dan permintaan peningkatan batas pengeluaran untuk organisasi Claude Enterprise Anda menggunakan Claude Enterprise Admin API. Batas pengeluaran memungkinkan Anda membatasi pengeluaran kredit penggunaan setiap anggota selama periode berulang, melihat dari mana batas setiap anggota diwariskan, dan meninjau atau bertindak atas permintaan anggota untuk batas yang lebih tinggi.

Untuk pelaporan penggunaan dan biaya per pengguna dan berbasis waktu, lihat panduan referensi Claude Enterprise Analytics API.

Claude Enterprise Admin API saat ini dalam beta publik dan tersedia untuk organisasi dengan paket Enterprise dengan kredit penggunaan diaktifkan.

Ikhtisar

Ada delapan endpoint di dua sumber daya:

Sumber Daya	Endpoint	Digunakan untuk
Batas pengeluaran	`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}`	Baca batas efektif setiap anggota dan pengeluaran periode hingga saat ini; atur atau hapus penggantian per pengguna.
Permintaan peningkatan batas pengeluaran	`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`	Daftar permintaan anggota untuk batas yang lebih tinggi, dengan konteks yang diperlukan untuk memutuskan; setujui atau tolak setiap permintaan.

Gunakan endpoint batas pengeluaran untuk menjawab, "Batas apa yang berlaku untuk setiap anggota, dari mana asalnya, dan seberapa dekat mereka dengannya?" dan untuk mengatur penggantian per pengguna. Gunakan endpoint permintaan peningkatan batas pengeluaran untuk menangani antrian permintaan yang dikirimkan anggota.

Prasyarat dan autentikasi

Organisasi Anda harus berada di paket Claude Enterprise.
Kredit penggunaan harus diaktifkan untuk organisasi Anda. Pemilik Utama Anda dapat mengaktifkan ini di bawah Pengaturan Penagihan di Claude.
Pemilik Utama perlu membuat kunci Admin API dengan satu atau kedua cakupan berikut:
- read:spend_limits (diperlukan untuk semua endpoint GET)
- write:spend_limits (diperlukan untuk endpoint POST dan DELETE)

Teruskan kunci di header x-api-key pada setiap permintaan.

Penting: Jangan bagikan kunci API secara publik atau periksa ke dalam kontrol sumber.

URL Dasar

https://api.anthropic.com

Pembatasan laju

Semua delapan endpoint berbagi batas per organisasi tunggal sebesar 60 permintaan per menit. Permintaan di atas batas mengembalikan 429 Terlalu Banyak Permintaan.

Paginasi

GET /v1/organizations/spend_limits/effective dan GET /v1/organizations/spend_limit_increase_requests dipaginasi dengan kursor buram. Permintaan pertama mengembalikan hingga baris limit ditambah kursor next_page. Teruskan kursor itu tanpa perubahan sebagai parameter page pada permintaan berikutnya, dan ulangi sampai next_page adalah null.

Penting: Jangan ubah parameter kueri di tengah-tengah urutan. Kursor terikat pada filter yang mengeluarkannya. Jika Anda mengubah user_ids[], status[], atau actor_ids[] dan meneruskan kursor lama, Anda akan mendapatkan 400 dengan "kursor tidak cocok dengan parameter kueri saat ini". Mulai urutan baru dari halaman pertama sebagai gantinya.

Perlakukan string kursor sebagai buram: jangan parse, ubah, atau buatnya sendiri.

Serialisasi parameter daftar

Parameter daftar menggunakan notasi kurung: ulangi nama parameter dengan [] untuk setiap nilai.

user_ids[]=user_01AbCdEfGh&user_ids[]=user_01JkLmNoPq

Respons kesalahan

Status	Arti
400	Input tidak valid, nilai parameter yang tidak didukung, kursor halaman tidak cocok dengan parameter saat ini, atau prasyarat tidak terpenuhi (lihat Validasi per endpoint).
401	Header `x-api-key` hilang.
403	Kunci API tidak memiliki cakupan yang diperlukan (`read:spend_limits` atau `write:spend_limits`).
404	Sumber daya tidak ditemukan, atau kunci API tidak dikenal, kadaluarsa, atau dicabut.
429	Batas laju terlampaui.
500	Kesalahan internal.

Badan kesalahan memiliki bentuk:

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

error.type adalah diskriminator yang bergantung pada status: invalid_request_error (400), authentication_error (401), permission_error (403), not_found_error (404), rate_limit_error (429), api_error (500). request_id selalu ada dan merupakan nilai yang harus dikutip saat menghubungi dukungan. Tabel Validasi di bawah setiap titik akhir mencantumkan pesan spesifik.

Konsep

Hierarki batas pengeluaran

Pengeluaran kredit penggunaan setiap anggota dibatasi oleh batas pengeluaran efektif, yang diselesaikan dari hierarki tingkat cakupan. Ketika anggota tidak memiliki penggantian per-pengguna, mereka mewarisi batas yang dikonfigurasi untuk tingkat kursi mereka, grup mereka (jika organisasi Anda menggunakan batas berbasis grup), atau default di seluruh organisasi.

Membaca GET /v1/organizations/spend_limits/effective mengembalikan setiap anggota saat ini dengan batas efektif yang diselesaikan mereka, di mana batas itu diselesaikan dari (source), dan pengeluaran periode-ke-tanggal mereka. Menetapkan penggantian per-pengguna melalui POST /v1/organizations/spend_limits mengikat anggota ke batas tertentu terlepas dari apa yang akan mereka warisi. Menghapus penggantian mengembalikan mereka ke batas yang diwarisi.

Cakupan

Cakupan mengidentifikasi tingkat di mana batas pengeluaran ditulis atau diselesaikan:

Tipe	Bidang	Makna
`user`	`user_id`	Anggota tertentu. `user_id` cocok dengan ID yang dikembalikan oleh titik akhir pengguna Admin API.
`seat_tier`	`seat_tier`	Default tingkat kursi. Nilai `seat_tier` adalah pengidentifikasi yang sepenuhnya memenuhi syarat seperti `enterprise_standard` atau `enterprise_tier_1`; nilai tambahan dapat ditambahkan.
`rbac_group`	`rbac_group_id`	Default grup, ketika organisasi Anda mengelola batas berdasarkan grup.
`organization`	—	Default di seluruh organisasi.

scope.type adalah string terbuka. Klien harus memperlakukan nilai yang tidak dikenal sebagai buram dan jatuh melalui daripada gagal. Jenis cakupan tambahan dapat ditambahkan di masa depan.

Periode

period adalah jendela berulang di mana batas diterapkan dan pengeluaran disetel ulang. Satu-satunya nilai hari ini adalah "monthly".

period adalah string terbuka. Klien harus memperlakukan nilai yang tidak dikenal sebagai buram dan jatuh melalui daripada gagal. Nilai periode tambahan dapat ditambahkan di masa depan.

Jumlah dan mata uang

Semua nilai moneter adalah string dalam unit minor dari mata uang penagihan organisasi (sen, untuk USD). Misalnya, "50000" mewakili 500,00 USD. Parsing sebagai desimal dan bagi dengan 100 untuk menampilkan dolar. Hindari floating-point biner untuk nilai besar.

amount adalah nullable: null berarti unlimited (tanpa batas). "0" berarti kredit penggunaan disabled untuk anggota itu.

period_to_date_spend adalah kredit penggunaan yang terkumpul anggota sejak awal period saat ini, dalam format unit minor yang sama. Mungkin termasuk bagian pecahan (misalnya, "41280.125").

Siklus hidup permintaan peningkatan pengeluaran

Permintaan peningkatan batas pengeluaran dibuat ketika anggota mengklik "minta penggunaan lebih" di claude.ai. Permintaan tidak dibuat melalui API ini.

Status	Makna
`pending`	Menunggu tindakan admin. Permintaan biasanya membawa `spend_summary` langsung sehingga Anda dapat melihat batas efektif saat ini anggota dan pengeluaran periode-ke-tanggal saat memutuskan. `spend_summary` mungkin `null` jika tidak dapat dihitung, jadi tangani kasus itu.
`approved`	Permintaan diselesaikan dengan persetujuan: baik admin menyetujuinya secara eksplisit (menulis batas pengeluaran per-pengguna pada jumlah yang disediakan admin), tindakan admin lain membuat kredit penggunaan tersedia untuk anggota (misalnya, menaikkan batas tingkat kursi atau mengaktifkan penagihan kredit penggunaan untuk organisasi), atau dukungan Anthropic menaikkan batas atas nama organisasi. `spend_summary` adalah `null`.
`denied`	Admin menolak. `spend_summary` adalah `null`. Claude.ai menyembunyikan tombol permintaan anggota itu selama 30 hari dari `resolved_at`; admin masih dapat menaikkan batas anggota secara langsung kapan saja.

Baik approved maupun denied adalah terminal. Anggota memiliki paling banyak satu permintaan pending pada satu waktu.

Menyetujui melalui POST …/approve menulis baris batas pengeluaran per-pengguna yang sama dengan yang ditulis POST /v1/organizations/spend_limits. Menetapkan batas pengeluaran secara langsung tidak tidak mentransisikan permintaan yang tertunda. Gunakan titik akhir persetujuan untuk menyelesaikan permintaan.

Secara default, Anthropic mengirim email kepada anggota ketika permintaan mereka disetujui atau ditolak. Lewati suppress_notification: true pada persetujuan atau penolakan untuk menekan email itu (misalnya, ketika sistem Anda sendiri memberi tahu anggota).

Objek SpendLimit

Batas yang dikonfigurasi pada satu tingkat cakupan.

{
  "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"
}

Bidang	Tipe	Deskripsi
`type`	string	Selalu `"spend_limit"`.
`id`	string	Diawali dengan `spl_`.
`created_at`	string (RFC 3339)	Kapan batas ini pertama kali ditetapkan.
`updated_at`	string (RFC 3339)	Kapan batas ini terakhir diubah.
`scope`	Cakupan	Tingkat tempat batas ini ditulis. Lihat bagian "Cakupan".
`amount`	string atau null	Batas untuk `period`, dalam unit minor. `null` berarti tidak terbatas.
`currency`	string	ISO 4217. Mata uang penagihan organisasi.
`period`	string	Jendela berulang tempat `amount` diberlakukan. Lihat bagian "Periode".

Objek SpendSummary

Baris laporan per-anggota yang dihitung: batas efektif anggota, asalnya, dan pengeluaran mereka hingga periode saat ini. Bukan sumber daya yang dapat dialamatkan (tidak ada 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"
}

Bidang	Tipe	Deskripsi
`scope`	Cakupan (`type: "user"`)	Anggota yang menjadi baris ini.
`amount`	string atau null	Batas efektif untuk `period`, dalam unit minor. `null` berarti tidak terbatas; `"0"` berarti kredit penggunaan dinonaktifkan.
`currency`	string	ISO 4217.
`period`	string	Periode batas pengeluaran yang `source` selesaikan. Lihat bagian "Periode".
`source`	Cakupan	Tempat `amount` diselesaikan dari dalam hierarki. Sama dengan `scope` ketika anggota memiliki penggantian per-pengguna.
`spend_limit_id`	string	ID dari `SpendLimit` yang `source` selesaikan. Ambil dengan `GET /v1/organizations/spend_limits/{spend_limit_id}`.
`period_to_date_spend`	string	Kredit penggunaan anggota yang terkumpul sejak awal `period` saat ini, dalam unit minor.

Objek 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"
  }
}

Bidang	Tipe	Deskripsi
`type`	string	Selalu `"spend_limit_increase_request"`.
`id`	string	Diawali dengan `slir_`.
`created_at`	string (RFC 3339)	Saat anggota mengirimkan permintaan.
`status`	string	`pending`, `approved`, atau `denied`.
`resolved_at`	string (RFC 3339) atau null	Saat permintaan disetujui atau ditolak. `null` saat tertunda.
`resolved_by`	Actor atau null	Siapa yang menyetujui atau menolak permintaan: baik `user_actor` (admin bertindak di claude.ai) atau `scoped_api_key_actor` (diselesaikan melalui API ini). Ketika permintaan diselesaikan secara otomatis oleh tindakan admin di claude.ai (misalnya, menaikkan batas tingkat kursi, mengaktifkan penagihan kredit penggunaan untuk organisasi, atau menaikkan batas anggota), `resolved_by` adalah `user_actor` admin yang bertindak. `null` saat tertunda, ketika akun admin yang menyelesaikan telah dihapus, atau ketika permintaan diselesaikan oleh dukungan Anthropic. `scoped_api_key_actor` dapat mereferensikan kunci yang telah dihapus atau dicabut. Perlakukan `scoped_api_key_id` sebagai referensi historis dan toleransi kegagalan pencarian.
`actor`	Actor (`user_actor`)	Anggota yang mengirimkan permintaan.
`spend_summary`	SpendSummary atau null	Konteks keputusan langsung untuk pemohon: batas efektif mereka dan pengeluaran periode-ke-tanggal. Hadir saat `status` tertunda (mungkin `null` jika ringkasan tidak dapat dihitung); selalu `null` setelah diselesaikan.

Actor

Bidang	Tipe	Deskripsi
`type`	string	`user_actor` atau `scoped_api_key_actor`.
`user_id`	string	Hadir di `user_actor`. ID pengguna; nilai yang sama diterima oleh `actor_ids[]`.
`name`	string atau null	Hadir di `user_actor`. Nama pengguna; `null` jika akun telah dihapus atau pengguna belum menetapkan nama.
`email_address`	string atau null	Hadir di `user_actor`. Email pengguna; `null` jika akun telah dihapus.
`scoped_api_key_id`	string	Hadir di `scoped_api_key_actor`. Diawali dengan `apikey_`.

Batas pengeluaran

1. Daftar batas pengeluaran efektif

GET /v1/organizations/spend_limits/effective

Mengembalikan setiap anggota organisasi saat ini dengan batas efektif yang diselesaikan dan pengeluaran periode-ke-tanggal mereka. Anggota tanpa penggantian per-pengguna muncul dengan source.type dari seat_tier, rbac_group, atau organization. Anggota mantan tidak terdaftar.

Memerlukan cakupan: read:spend_limits.

Parameter kueri

Bidang	Tipe	Diperlukan	Bawaan	Deskripsi
`user_ids[]`	string, maks 100 entri	Tidak	semua anggota	Batasi ke anggota tertentu. Menerima ID `user_...`. Entri yang bukan anggota saat ini dihilangkan secara diam-diam dari `data`.
`limit`	integer 1–1000	Tidak	20	Baris per halaman.
`page`	string kursor buram	Tidak	—	Nilai `next_page` dari respons sebelumnya.

Bidang respons

Bidang	Tipe	Deskripsi
`data`	array dari SpendSummary	Satu entri per anggota, diurutkan berdasarkan kapan anggota bergabung dengan organisasi (terbaru terlebih dahulu).
`next_page`	string atau null	Kursor buram untuk halaman berikutnya; `null` ketika tidak ada halaman lagi.

Contoh permintaan

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

Contoh respons

{
  "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_..."
}

Validasi

Kondisi	Status	Pesan
Entri `user_ids[]` salah format	400	`user_ids[]: entry is not a valid user ID`
`user_ids[]` memiliki lebih dari 100 entri	400
`limit` di luar 1–1000	400
Kursor `page` tidak valid	400	`page: kursor tidak valid`
`page` kursor tidak cocok dengan `user_ids[]` saat ini	400	`page: kursor tidak cocok dengan parameter kueri saat ini`
`page` kursor dari versi API yang berbeda	400	`page: kursor dikeluarkan oleh versi API yang berbeda`
Organisasi tidak berada pada paket Enterprise	400	`endpoint ini tidak didukung untuk tipe organisasi ini`
Penagihan kredit penggunaan tidak diaktifkan	400	`penagihan kelebihan tidak diaktifkan untuk organisasi ini`

2. Dapatkan batas pengeluaran

GET /v1/organizations/spend_limits/{spend_limit_id}

Mengembalikan batas pengeluaran tunggal berdasarkan ID. Gunakan ini untuk memeriksa baris yang direferensikan oleh SpendSummary.spend_limit_id atau respons POST.

Memerlukan cakupan: read:spend_limits.

Parameter jalur

Bidang	Tipe	Deskripsi
`spend_limit_id`	string	Diawali dengan `spl_`.

Respons

Objek SpendLimit.

Contoh permintaan

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

Validasi

Kondisi	Status	Pesan
`spend_limit_id` tidak ditemukan di organisasi ini	404
Organisasi tidak berada pada paket Enterprise	400	`endpoint ini tidak didukung untuk tipe organisasi ini`
Penagihan kredit penggunaan tidak diaktifkan	400	`penagihan kelebihan tidak diaktifkan untuk organisasi ini`

3. Tetapkan batas pengeluaran

POST /v1/organizations/spend_limits

Menetapkan penggantian batas pengeluaran per-pengguna. Upsert: menetapkan batas untuk pengguna yang sudah memiliki batas akan menimpanya di tempat.

Hanya scope.type: "user" yang diterima. Default tingkat kursi, grup, dan tingkat organisasi dikonfigurasi dalam pengaturan claude.ai.

Menetapkan batas pengeluaran secara langsung tidak mengalihkan permintaan peningkatan tertunda anggota. Gunakan endpoint persetujuan untuk menyelesaikan permintaan.

Memerlukan cakupan: write:spend_limits.

Badan permintaan

Bidang	Tipe	Diperlukan	Deskripsi
`scope`	objek	Ya	`{ "type": "user", "user_id": "user_..." }`.
`amount`	string atau null	Ya	Batas baru untuk `period`, dalam unit minor, sebagai string desimal bilangan bulat non-negatif. `"0"` menonaktifkan kredit penggunaan untuk anggota. `null` menghapus batas (tidak terbatas).
`period`	string	Tidak	Default `"monthly"`. Lihat bagian "Period".

Respons

Objek SpendLimit yang mencerminkan penggantian yang ditulis.

Contoh permintaan

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"}'

Contoh respons

{
  "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"
}

Validasi

Kondisi	Status	Pesan
`scope.type` bukan `"user"`	400	`scope.type: belum didukung`
`scope.user_id` tidak valid	400	`scope.user_id: tidak valid`
`scope.user_id` bukan anggota organisasi ini	400	`scope.user_id: bukan anggota organisasi ini`
`amount` negatif, pecahan, atau bukan string desimal yang valid	400
`period` bukan `"monthly"`	400	`period: belum didukung`
Organisasi tidak dalam paket Enterprise	400	`endpoint ini tidak didukung untuk tipe organisasi ini`
Penagihan kredit penggunaan tidak diaktifkan	400	`penagihan overage tidak diaktifkan untuk organisasi ini`

4. Hapus batas pengeluaran

DELETE /v1/organizations/spend_limits/{spend_limit_id}

Menghapus penggantian per-pengguna sehingga anggota kembali ke batas yang diwariskan (tingkat kursi, grup, atau default organisasi). Baris tingkat kursi, grup, dan organisasi tidak dapat dihapus melalui endpoint ini.

Memerlukan cakupan: write:spend_limits.

Parameter jalur

Bidang	Tipe	Deskripsi
`spend_limit_id`	string	Diawali dengan `spl_`. Harus berupa ID penggantian per-pengguna.

Respons

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

Contoh permintaan

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

Validasi

Kondisi	Status	Pesan
`spend_limit_id` tidak ditemukan di organisasi ini	404
`spend_limit_id` adalah baris tingkat kursi, grup, atau organisasi	400	`Hanya batas pengeluaran per pengguna yang dapat dihapus melalui titik akhir ini.`
Organisasi tidak berada pada paket Enterprise	400	`titik akhir ini tidak didukung untuk jenis organisasi ini`
Penagihan kredit penggunaan tidak diaktifkan	400	`penagihan kelebihan tidak diaktifkan untuk organisasi ini`

Permintaan peningkatan batas pengeluaran

5. Daftar permintaan peningkatan

GET /v1/organizations/spend_limit_increase_requests

Mencantumkan permintaan peningkatan, yang paling baru terlebih dahulu. Permintaan yang pemintanya tidak lagi menjadi anggota organisasi dikecualikan.

Memerlukan cakupan: read:spend_limits.

Parameter kueri

Bidang	Jenis	Diperlukan	Default	Deskripsi
`status[]`	satu atau lebih dari `pending`, `approved`, `denied`	Tidak	semua	Filter berdasarkan status. Ulangi parameter untuk beberapa nilai.
`actor_ids[]`	string	Tidak	semua	Filter berdasarkan peminta. Menerima ID `user_...`.
`limit`	integer 1–1000	Tidak	20	Baris per halaman.
`page`	string kursor buram	Tidak	—	Nilai `next_page` dari respons sebelumnya.

Bidang respons

Bidang	Jenis	Deskripsi
`data`	array dari SpendLimitIncreaseRequest	Diurutkan berdasarkan `created_at` menurun.
`next_page`	string atau null	Kursor buram untuk halaman berikutnya; `null` ketika tidak ada halaman lagi.

Contoh permintaan

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

Contoh respons

{
  "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
}

Validasi

Kondisi	Status	Pesan
`actor_ids[]` entri tidak terbentuk dengan baik	400	`actor_ids[]: ID pengguna yang ditandai tidak valid`
`limit` di luar 1–1000	400
`page` kursor tidak terbentuk dengan baik	400	`format kursor halaman tidak valid` atau `kursor halaman tidak valid`
`page` kursor tidak cocok dengan `status[]` atau `actor_ids[]` saat ini	400	`kursor halaman tidak cocok dengan parameter kueri saat ini`
`page` kursor dari versi API yang berbeda	400	`kursor halaman dikeluarkan oleh versi API yang berbeda; mulai ulang paginasi`
Organisasi tidak berada pada paket Enterprise	400	`titik akhir ini tidak didukung untuk jenis organisasi ini`
Penagihan kredit penggunaan tidak diaktifkan	400	`penagihan kelebihan tidak diaktifkan untuk organisasi ini`

6. Dapatkan permintaan peningkatan

GET /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}

Mengembalikan permintaan peningkatan tunggal.

Memerlukan cakupan: read:spend_limits.

Parameter jalur

Bidang	Tipe	Deskripsi
`spend_limit_increase_request_id`	string	Diawali dengan `slir_`.

Respons

Objek SpendLimitIncreaseRequest.

Contoh permintaan

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

Validasi

Kondisi	Status	Pesan
Permintaan tidak ditemukan di organisasi ini	404
Pemohon tidak lagi menjadi anggota organisasi ini	404
Organisasi tidak berada pada paket Enterprise	400	`endpoint ini tidak didukung untuk tipe organisasi ini`
Penagihan kredit penggunaan tidak diaktifkan	400	`penagihan kelebihan tidak diaktifkan untuk organisasi ini`

7. Setujui permintaan peningkatan

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

Menyetujui permintaan yang tertunda. Menulis batas pengeluaran per pengguna di amount untuk pemohon dan mengalihkan permintaan ke approved. Permintaan tidak membawa jumlah yang diminta, admin menyediakan batas baru saat persetujuan.

Memerlukan cakupan: write:spend_limits.

Parameter jalur

Bidang	Tipe	Deskripsi
`spend_limit_increase_request_id`	string	Diawali dengan `slir_`.

Badan permintaan

Bidang	Tipe	Diperlukan	Default	Deskripsi
`amount`	string	Ya	—	Batas baru per pengguna untuk `period`, dalam unit minor, sebagai string desimal bilangan bulat non-negatif.
`period`	string	Tidak	`"monthly"`	Lihat bagian "Periode".
`suppress_notification`	boolean	Tidak	`false`	Jika `true`, Anthropic tidak mengirim email kepada anggota bahwa permintaan mereka telah disetujui.

Respons

SpendLimitIncreaseRequest dalam status approved, dengan bidang spend_limit tambahan yang berisi SpendLimit yang ditulis.

Contoh permintaan

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}'

Contoh respons

{
  "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"
  }
}

Validasi

Kondisi	Status	Pesan
Permintaan tidak ditemukan di organisasi ini	404
Pemohon tidak lagi menjadi anggota organisasi ini	404
Permintaan sudah `disetujui` atau `ditolak`	400	`permintaan peningkatan batas pengeluaran sudah diselesaikan`
`jumlah` negatif, pecahan, atau bukan string desimal yang valid	400
`periode` bukan `"bulanan"`	400	`periode: belum didukung`
Organisasi tidak berada pada paket Enterprise	400	`titik akhir ini tidak didukung untuk jenis organisasi ini`
Penagihan kredit penggunaan tidak diaktifkan	400	`penagihan kelebihan tidak diaktifkan untuk organisasi ini`

8. Tolak permintaan peningkatan

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

Menolak permintaan yang tertunda. Idempoten pada ditolak: menolak permintaan yang sudah ditolak mengembalikan 200 dengan sumber daya yang ada. Menolak permintaan yang sudah disetujui ditolak sehingga otomasi dapat membedakan percobaan ulang dari keputusan yang bertentangan.

Memerlukan cakupan: write:spend_limits.

Parameter jalur

Bidang	Tipe	Deskripsi
`spend_limit_increase_request_id`	string	Diawali dengan `slir_`.

Badan permintaan

Bidang	Tipe	Diperlukan	Default	Deskripsi
`suppress_notification`	boolean	Tidak	`false`	Jika `true`, Anthropic tidak mengirim email kepada anggota bahwa permintaan mereka ditolak.

Respons

SpendLimitIncreaseRequest dengan status ditolak.

Contoh permintaan

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}'

Validasi

Kondisi	Status	Pesan
Permintaan tidak ditemukan di organisasi ini	404
Pemohon tidak lagi menjadi anggota organisasi ini	404
Permintaan sudah `disetujui`	400	`permintaan peningkatan batas pengeluaran sudah disetujui`
Permintaan sudah `ditolak`	— (200, idempotent)
Organisasi tidak berada pada paket Enterprise	400	`endpoint ini tidak didukung untuk tipe organisasi ini`
Kredit penggunaan tidak diaktifkan	400	`penagihan overage tidak diaktifkan untuk organisasi ini`