> This page is for API, version 2026-01-01 (Stable) (default). > For other versions, use one of these documentation indexes: > - 2026-01-01 (Stable) (default): https://developer.deel.com/api/stable/llms.txt > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developer.deel.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.deel.com/_mcp/server. # Retrieve the IT seat subscription GET https://api.letsdeel.com/rest/it/seats/status Reports your organization's IT-seat subscription so HRIS and finance automations can see how many seats are paid for, how many are already taken, how many are free and what one more seat costs per month — before assigning workers via `POST /rest/it/seats/assign`. Returns the subscription in force today; if your organization is between subscriptions, the most recent one is returned with its status, so an expired subscription is still visible. Only organizations on a per-seat plan can use this endpoint. **Token scopes**: `it-seats:read` **Beta**: this version requires the `X-Beta: true` request header and its contract may change before it is promoted to stable. It is scheduled to become stable on 2026-12-25. Reference: https://developer.deel.com/api/reference/endpoints/it-seats/retrieve-the-it-seat-contract-v-2026-09-25 ## Authentication - `Authorization` header (bearer token, required) — ## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication) - `Authorization` header (bearer token, required) — Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/ ## Servers - `https://api.letsdeel.com/rest` (Production, default) - `https://api-staging.letsdeel.com/rest` (Demo) ## Request ### Headers - `X-Beta` (enum, required, default: true) — Opts in to the beta version of this endpoint. Must be `true`. - Allowed values: `true` ## Response ### 200 OK - `data` (ItSeatsStatusGetResponsesContentApplicationJsonSchemaData, required) ## Errors ### 400 Bad Request Error Bad Request - `errors` (list of ItSeatsStatusGetResponsesContentApplicationJsonSchemaErrorsItems, required) ### 401 Unauthorized Error Unauthorized - `errors` (list of ItSeatsStatusGetResponsesContentApplicationJsonSchemaErrorsItems, required) ### 403 Forbidden Error Forbidden - `errors` (list of ItSeatsStatusGetResponsesContentApplicationJsonSchemaErrorsItems, required) ### 404 Not Found Error Not Found - `errors` (list of ItSeatsStatusGetResponsesContentApplicationJsonSchemaErrorsItems, required) ### 409 Conflict Error Conflict - `errors` (list of ItSeatsStatusGetResponsesContentApplicationJsonSchemaErrorsItems, required) ### 500 Internal Server Error Internal Server Error - `errors` (list of ItSeatsStatusGetResponsesContentApplicationJsonSchemaErrorsItems, required) ## Types ### ItSeatsStatusGetResponsesContentApplicationJsonSchemaData - `id` (string, required) — Unique identifier of the IT seat subscription. - `term` (enum, required) — Committed length of the subscription. - Allowed values: `12_MONTHS`, `24_MONTHS`, `36_MONTHS`, `CUSTOM` - `status` (enum, required) — Current status of the subscription. - Allowed values: `ACTIVE`, `EXPIRED`, `TRIAL` - `end_date` (string, required) — Last day the subscription is in force. - `created_at` (string, required) — When the subscription was created. - `paid_seats` (long, required) — Number of seats the organization pays for. - `start_date` (string, required) — First day the subscription is in force. - `assigned_seats` (long, required) — Number of seats held by a worker, whether or not the seat's paid features are in use yet. - `available_seats` (long, required) — Number of paid seats free to assign right now. - `monthly_seat_price` (ItSeatsStatusGetResponsesContentApplicationJsonSchemaDataMonthlySeatPrice, required) — Price of each seat per month. - `pending_approval_seats` (long, required) — Number of seats pending purchase approval. These do not consume a paid seat until approved. ### ItSeatsStatusGetResponsesContentApplicationJsonSchemaErrorsItems - `code` (string, required) — Error code of the handler which produced the returned error - `field` (string, required, nullable) — The field name where input validation failed - `message` (string, required) — Description of the returned error ### ItSeatsStatusGetResponsesContentApplicationJsonSchemaDataMonthlySeatPrice Price of each seat per month. - `amount` (string, required) — Amount - `currency` (enum, required) — Three-letter currency code for the price - Allowed values: `AED`, `AFN`, `ALL`, `AMD`, `ANG`, `AOA`, `ARS`, `AUD`, `AWG`, `AZN`, `BAM`, `BDT`, `BGN`, `BHD`, `BIF`, `BMD`, `BOB`, `BRL`, `BSD`, `BTN`, `BWP`, `BYN`, `BZD`, `CAD`, `CDF`, `CHF`, `CLP`, `CNY`, `COP`, `CRC`, `CUC`, `CVE`, `CZK`, `DJF`, `DKK`, `DOP`, `DZD`, `EGP`, `ERN`, `ETB`, `EUR`, `FJD`, `FKP`, `GBP`, `GEL`, `GHS`, `GIP`, `GMD`, `GNF`, `GTQ`, `GYD`, `HKD`, `HNL`, `HRK`, `HTG`, `HUF`, `IDR`, `ILS`, `INR`, `IQD`, `IRR`, `ISK`, `JMD`, `JOD`, `JPY`, `KES`, `KGS`, `KHR`, `KMF`, `KPW`, `KRW`, `KWD`, `KYD`, `KZT`, `LAK`, `LBP`, `LKR`, `LRD`, `LSL`, `LTL`, `LYD`, `MAD`, `MDL`, `MGA`, `MKD`, `MMK`, `MNT`, `MRU`, `MUR`, `MVR`, `MWK`, `MXN`, `MYR`, `MZN`, `NAD`, `NGN`, `NIO`, `NOK`, `NPR`, `NZD`, `OMR`, `PAB`, `PEN`, `PGK`, `PHP`, `PKR`, `PLN`, `PYG`, `QAR`, `RON`, `RSD`, `RUB`, `RWF`, `SAR`, `SBD`, `SCR`, `SDG`, `SEK`, `SGD`, `SHP`, `SLL`, `SOS`, `SRD`, `SSP`, `STD`, `SYP`, `SZL`, `THB`, `TJS`, `TMT`, `TND`, `TOP`, `TRY`, `TTD`, `TWD`, `TZS`, `UAH`, `UGX`, `USD`, `UYU`, `UZS`, `VEF`, `VND`, `VUV`, `WST`, `XAF`, `XCD`, `XOF`, `XPF`, `YER`, `ZAR`, `ZMW`, `ZWD` ## Examples **Response** ```json { "data": { "id": "3b1a0000-0000-0000-0000-000000000000", "term": "12_MONTHS", "status": "ACTIVE", "end_date": "2027-01-14", "created_at": "2026-01-15T09:00:00Z", "paid_seats": 25, "start_date": "2026-01-15", "assigned_seats": 18, "available_seats": 7, "monthly_seat_price": { "amount": "1999.99", "currency": "EUR" }, "pending_approval_seats": 2 } } ``` **SDK Code** ```python import requests url = "https://api.letsdeel.com/rest/it/seats/status" headers = { "X-Beta": "true", "Authorization": "Bearer " } response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.letsdeel.com/rest/it/seats/status'; const options = {method: 'GET', headers: {'X-Beta': 'true', Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.letsdeel.com/rest/it/seats/status" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("X-Beta", "true") req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.letsdeel.com/rest/it/seats/status") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["X-Beta"] = 'true' request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.letsdeel.com/rest/it/seats/status") .header("X-Beta", "true") .header("Authorization", "Bearer ") .asString(); ``` ```php request('GET', 'https://api.letsdeel.com/rest/it/seats/status', [ 'headers' => [ 'Authorization' => 'Bearer ', 'X-Beta' => 'true', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.letsdeel.com/rest/it/seats/status"); var request = new RestRequest(Method.GET); request.AddHeader("X-Beta", "true"); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "X-Beta": "true", "Authorization": "Bearer " ] let request = NSMutableURLRequest(url: NSURL(string: "https://api.letsdeel.com/rest/it/seats/status")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```