Skip to content

Deel: Retrieve a product's prices for a delivery country

Deel itProducts.retrieveItProductPrices: arguments, response, policy and SDK examples.

← IT products operations · Get started

Operation deel.itproducts_retrieveitproductprices_v2026_10_28

Provider route: GET /it/products/{product_id}/prices/{country_code}. Alter supplies the connection’s credentials and routing.

Install @alter-ai/sdk @alter-ai/deel with npm, or alter-sdk-deel with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { DeelIntegration } from "@alter-ai/deel";
async function execute(input: Parameters<DeelIntegration["itProducts"]["retrieveItProductPrices"]>[0]) {
const app = new App({ apiKey: process.env.ALTER_API_KEY! });
try {
const provider = new DeelIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
const call = await provider.itProducts.retrieveItProductPrices(input);
const result = await call.wait();
return result.bodyJson();
} finally {
await app.close();
}
}
import os
from alter_sdk import App
from alter_sdk_deel import DeelIntegration
async def execute(arguments):
async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
provider = DeelIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
call = await provider.it_products.retrieve_it_product_prices(arguments)
result = await call.wait()
return result.body_json()
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: not allowed
pathobjectRequired within parentAdditional keys: not allowed
path.product_idstringRequired within parentFormat: uuid
path.country_codestringRequired within parent
queryobjectOptionalAdditional keys: not allowed
query.variant_idsarrayOptional
query.variant_ids[]stringEach itemFormat: uuid
query.acquisition_typesarrayOptional
query.acquisition_types[]stringEach itemOne of: PURCHASE, RENTAL, REUSE
query.rental_termsarrayOptional
query.rental_terms[]stringEach itemOne of: MONTH_12, MONTH_24
query.payment_schemasarrayOptional
query.payment_schemas[]stringEach itemOne of: MONTHLY, UPFRONT
query.extendarrayOptional
query.extend[]stringEach itemOne of: AVAILABLE_ADDONS
headersobjectRequired within parentAdditional keys: not allowed
headers.X-BetastringRequired within parentDefault: true
One of: true

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

FieldTypePresenceDescription and constraints
$ModelRootExpand Retrieve a product’s prices for a delivery country — 200 response body

Referenced models: Retrieve a product’s prices for a delivery country — 200 response body

6 more schemas are linked from the tables above, on the schema pages.

Retrieve a product's prices for a delivery country — 200 response body
FieldTypePresenceDescription and constraints
$objectRoot
dataModelRequired within parentExpand Retrieve a product's prices for a delivery country — 200 response body — data

Referenced models: Retrieve a product's prices for a delivery country — 200 response body — data

Retrieve a product's prices for a delivery country — 200 response body — data
FieldTypePresenceDescription and constraints
$objectRoot
countryModelRequired within parentExpand Retrieve a product's prices for a delivery country — 200 response body — data country
ISO 3166 alpha-2 code of the delivery country the prices apply to
pricesarrayRequired within parentOne price per variant and contract setting the organization can order for delivery to the country. Rows are grouped by variant, cheapest variant first (by its lowest total_price), then by SKU. A variant that cannot be priced for the country is left out.
prices[]ModelEach itemExpand Retrieve a product's prices for a delivery country — 200 response body — data prices item
product_idstringRequired within parentUnique identifier of the product
Format: uuid

Referenced models: Retrieve a product's prices for a delivery country — 200 response body — data country, Retrieve a product's prices for a delivery country — 200 response body — data prices item

Retrieve a product's prices for a delivery country — 200 response body — data country
FieldTypePresenceDescription and constraints
$stringRootISO 3166 alpha-2 code of the delivery country the prices apply to
Known values: AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, IC, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW
Retrieve a product's prices for a delivery country — 200 response body — data prices item
FieldTypePresenceDescription and constraints
$objectRoot
asset_priceModelRequired within parentExpand Retrieve a product's prices for a delivery country — 200 response body — data prices item asset price
Equipment price over the whole contract, storefront fee excluded
available_addonsJSONRequired within parent
available_addons (anyOf 1)arrayAlternativeService and warranty addons this price can be ordered with, and what each costs on top of it. Null unless the request has `extend=AVAILABLE_ADDONS`.
available_addons (anyOf 1)[]ModelEach itemExpand Retrieve a product's prices for a delivery country — 200 response body — data prices item available addons null item
available_addons (anyOf 2)nullAlternativeService and warranty addons this price can be ordered with, and what each costs on top of it. Null unless the request has `extend=AVAILABLE_ADDONS`.
available_addons (anyOf 2)[]ModelEach itemExpand Retrieve a product's prices for a delivery country — 200 response body — data prices item available addons null item
contract_settingModelRequired within parentExpand Retrieve a product's prices for a delivery country — 200 response body — data prices item contract setting
Contract setting this price applies to. Submit it as `contract_setting` on `POST /rest/it/orders` to order at this price, leaving out null fields and adding `addons`, empty for none.
payments_countJSONRequired within parent
payments_count (anyOf 1)integerAlternativeNumber of payments over the contract. 1 for purchases and upfront rentals.
Format: int64
payments_count (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
price_per_paymentModelRequired within parentExpand Retrieve a product's prices for a delivery country — 200 response body — data prices item price per payment
Amount charged per payment, storefront fee included. Addons are priced separately in available_addons.
skuJSONRequired within parent
sku (anyOf 1)stringAlternativeSKU of the variant
sku (anyOf 2)nullAlternativeSKU of the variant
storefront_feeModelRequired within parentExpand Retrieve a product's prices for a delivery country — 200 response body — data prices item storefront fee
Storefront fee over the whole contract
total_priceModelRequired within parentExpand Retrieve a product's prices for a delivery country — 200 response body — data prices item total price
Total over the whole contract: asset_price plus storefront_fee. Addons are priced separately in available_addons.
variant_idstringRequired within parentUnique identifier of the variant this price is for. Submit it as `variant_id` on `POST /rest/it/orders`.
Format: uuid

Referenced models: Retrieve a product's prices for a delivery country — 200 response body — data prices item asset price, Retrieve a product's prices for a delivery country — 200 response body — data prices item available addons null item, Retrieve a product's prices for a delivery country — 200 response body — data prices item contract setting, Retrieve a product's prices for a delivery country — 200 response body — data prices item price per payment, Retrieve a product's prices for a delivery country — 200 response body — data prices item storefront fee, Retrieve a product's prices for a delivery country — 200 response body — data prices item total price

Retrieve a product's prices for a delivery country — 200 response body — data prices item asset price
FieldTypePresenceDescription and constraints
$objectRootEquipment price over the whole contract, storefront fee excluded
amountstringRequired within parentAmount
Format: decimal
currencyModelRequired within parentExpand Retrieve the IT seat subscription — 200 response body — data monthly seat price currency
Three-letter currency code for the price

Referenced models: Retrieve the IT seat subscription — 200 response body — data monthly seat price currency

Retrieve a product's prices for a delivery country — 200 response body — data prices item contract setting
FieldTypePresenceDescription and constraints
$objectRootContract setting this price applies to. Submit it as `contract_setting` on `POST /rest/it/orders` to order at this price, leaving out null fields and adding `addons`, empty for none.
acquisition_typestringRequired within parentHow the equipment is acquired
Known values: PURCHASE, RENTAL, REUSE
payment_schemaJSONRequired within parentHow the rental is billed. Null for purchases, which are paid upfront.
payment_schema (anyOf 1)stringAlternativeHow the rental is billed. Null for purchases, which are paid upfront.
Known values: MONTHLY, UPFRONT
payment_schema (anyOf 2)nullAlternative
rental_termJSONRequired within parentRental term length. Null for purchases.
rental_term (anyOf 1)stringAlternativeRental term length. Null for purchases.
Known values: MONTH_12, MONTH_24
rental_term (anyOf 2)nullAlternative
Retrieve a product's prices for a delivery country — 200 response body — data prices item price per payment
FieldTypePresenceDescription and constraints
$objectRootAmount charged per payment, storefront fee included. Addons are priced separately in available_addons.
amountstringRequired within parentAmount
Format: decimal
currencyModelRequired within parentExpand Retrieve the IT seat subscription — 200 response body — data monthly seat price currency
Three-letter currency code for the price

Referenced models: Retrieve the IT seat subscription — 200 response body — data monthly seat price currency

Retrieve a product's prices for a delivery country — 200 response body — data prices item storefront fee
FieldTypePresenceDescription and constraints
$objectRootStorefront fee over the whole contract
amountstringRequired within parentAmount
Format: decimal
currencyModelRequired within parentExpand Retrieve the IT seat subscription — 200 response body — data monthly seat price currency
Three-letter currency code for the price

Referenced models: Retrieve the IT seat subscription — 200 response body — data monthly seat price currency

SDK function policy ID: deel.itproducts_retrieveitproductprices_v2026_10_28. Catalog operation: itproducts_retrieveitproductprices_v2026_10_28. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

Required provider scopes: ["it-products:read"]

Pinned headers: {"X-Version": "2026-10-28"}

Official provider source

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.