Properties
| Name | Type | Description |
|---|---|---|
| gross_amount | object | net_amount + tax_amount |
| net_amount | string | (quantity * unit_price) - discount_amount |
| currency | object | Currency code in ISO 4217 format. E.g. 'NOK' |
| discount_amount | object | Deprecated, discount amount is only applicable at line item level |
| discount_rate | object | Deprecated, discount rate is only applicable at line item level |
| tax_amount | string | net_amount * tax_rate |
| invoice_details | object | Invoice details are provided by the merchant via Merchant Portal when invoice_type is DIRECT_INVOICE, Two Bank or a 3rd-party bank when invoice_type is FUNDED_INVOICE and empty when invoice_type is CA |
| recurring | object | If set to true, an invoice will be generated periodically according to the specification provided in recurring_details |
| buyer_department | object | The department the purchase is to be registered on |
| buyer_project | object | The project the purchase is to be registered on |
| buyer_purchase_order_number | object | The purchase order number the purchase should to be registered on |
| buyer_reference | object | General buyer reference field for information that is not covered by the specific reference fields, e.g. PO-number. Note: Maximum 140 characters |
| line_items | array | List of the line items that constitute the order |
| merchant_order_id | object | Your order ID registered in your solution |
| merchant_reference | object | Field set by merchant for adding a reference to be used internally by the merchant. Does not appear on invoice. |
| merchant_additional_info | object | Additional info the merchant can connect to the order |
| recurring_details | object | Currently not available |
| shipping_details | object | Optional shipping details to track the shipment |
| order_note | object | General note/message from the buyer to the merchant |
| billing_account_id | object | ID for the billing account to link to this order. Send null to remove an existing link. Do not pass terms when setting billing_account_id; billing account payment terms take precedence. Only allowed w |
| billing_address | object | Order billing address |
| shipping_address | object | Order shipping address |
| tax_subtotals | object | List of tax subtotals for unique tax brackets |
| terms | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/two/json-schema/two-edit-order-request-schema-schema.json",
"title": "EditOrderRequestSchema",
"x-generated": "2026-10-29",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/two-openapi.yaml#/components/schemas/EditOrderRequestSchema",
"properties": {
"gross_amount": {
"anyOf": [
{
"format": "decimal",
"pattern": "^-?[0-9]+(\\.[0-9]{0,2})?",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "net_amount + tax_amount",
"title": "Gross Amount"
},
"net_amount": {
"description": "(quantity * unit_price) - discount_amount",
"format": "decimal",
"pattern": "^-?[0-9]+(\\.[0-9]{0,2})?",
"title": "Net Amount",
"type": "string"
},
"currency": {
"$ref": "#/$defs/CurrencyEnum",
"description": "Currency code in ISO 4217 format. E.g. 'NOK'"
},
"discount_amount": {
"anyOf": [
{
"format": "decimal",
"pattern": "^-?[0-9]+(\\.[0-9]{0,2})?",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"deprecated": true,
"description": "Deprecated, discount amount is only applicable at line item level",
"title": "Discount Amount"
},
"discount_rate": {
"anyOf": [
{
"format": "decimal",
"pattern": "^-?[0-9]+(\\.[0-9]{0,6})?",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"deprecated": true,
"description": "Deprecated, discount rate is only applicable at line item level",
"title": "Discount Rate"
},
"tax_amount": {
"description": "net_amount * tax_rate",
"format": "decimal",
"pattern": "^-?[0-9]+(\\.[0-9]{0,2})?",
"title": "Tax Amount",
"type": "string"
},
"invoice_details": {
"anyOf": [
{
"$ref": "#/$defs/InvoiceDetailsRequestSchema"
},
{
"type": "null"
}
],
"default": null,
"description": "Invoice details are provided by the merchant via Merchant Portal when invoice_type is DIRECT_INVOICE, Two Bank or a 3rd-party bank when invoice_type is FUNDED_INVOICE and empty when invoice_type is CARD. Only editable for FUNDED_INVOICE orders if the order is in UNVERIFIED state."
},
"recurring": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "If set to true, an invoice will be generated periodically according to the specification provided in recurring_details",
"title": "Recurring"
},
"buyer_department": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The department the purchase is to be registered on",
"title": "Buyer Department"
},
"buyer_project": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The project the purchase is to be registered on",
"title": "Buyer Project"
},
"buyer_purchase_order_number": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The purchase order number the purchase should to be registered on",
"title": "Buyer Purchase Order Number"
},
"buyer_reference": {
"anyOf": [
{
"maxLength": 140,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "General buyer reference field for information that is not covered by the specific reference fields, e.g. PO-number. Note: Maximum 140 characters",
"title": "Buyer Reference"
},
"line_items": {
"description": "List of the line items that constitute the order",
"items": {
"$ref": "#/$defs/LineItemRequestSchema"
},
"title": "Line Items",
"type": "array"
},
"merchant_order_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Your order ID registered in your solution",
"title": "Merchant Order Id"
},
"merchant_reference": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Field set by merchant for adding a reference to be used internally by the merchant. Does not appear on invoice.",
"title": "Merchant Reference"
},
"merchant_additional_info": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Additional info the merchant can connect to the order",
"title": "Merchant Additional Info"
},
"recurring_details": {
"anyOf": [
{
"$ref": "#/$defs/RecurringDetailsSchema"
},
{
"type": "null"
}
],
"default": null,
"description": "Currently not available"
},
"shipping_details": {
"anyOf": [
{
"$ref": "#/$defs/ShippingDetailsSchema"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional shipping details to track the shipment"
},
"order_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "General note/message from the buyer to the merchant",
"title": "Order Note"
},
"billing_account_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ID for the billing account to link to this order. Send null to remove an existing link. Do not pass terms when setting billing_account_id; billing account payment terms take precedence. Only allowed while the order is editable (pre-fulfillment). The billing account buyer company must match the order buyer company, must belong to the same merchant as the order, and cannot be combined with INSTALMENTS terms or terms.duration_days_calculated_from.",
"title": "Billing Account Id"
},
"billing_address": {
"$ref": "#/$defs/CreateAddressRequestSchema",
"description": "Order billing address"
},
"shipping_address": {
"$ref": "#/$defs/CreateAddressRequestSchema",
"description": "Order shipping address"
},
"tax_subtotals": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/TaxSubtotalSchema"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "List of tax subtotals for unique tax brackets",
"title": "Tax Subtotals"
},
"terms": {
"anyOf": [
{
"description": "For backwards compatibility, `type` can be omitted for instalment terms, if the fields period and number_of_instalments are populated. It is recommended that that clients always provide a type value.",
"oneOf": [
{
"$ref": "#/$defs/OrderInstalmentTerms"
},
{
"$ref": "#/$defs/OrderNetTerms"
}
]
},
{
"type": "null"
}
],
"default": null,
"title": "Terms"
}
},
"required": [
"billing_address",
"currency",
"gross_amount",
"line_items",
"net_amount",
"shipping_address",
"tax_amount",
"tax_subtotals"
],
"type": "object",
"$defs": {
"BankAccountSchema": {
"properties": {
"id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"bban": {
"anyOf": [
{
"maxLength": 30,
"minLength": 7,
"pattern": "^[0-9A-Za-z]*$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Bban"
},
"iban": {
"anyOf": [
{
"maxLength": 34,
"minLength": 15,
"pattern": "^[0-9A-Za-z]*$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Iban"
},
"bic": {
"anyOf": [
{
"maxLength": 12,
"minLength": 8,
"pattern": "^[0-9A-Za-z]*$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Bic"
},
"country_code": {
"anyOf": [
{
"$ref": "#/$defs/CountryCodeEnum"
},
{
"type": "null"
}
],
"default": null
},
"branch_sort_code": {
"anyOf": [
{
"maxLength": 9,
"pattern": "^[0-9]*$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Branch Sort Code"
},
"local_account_number": {
"anyOf": [
{
"maxLength": 12,
"minLength": 8,
"pattern": "^[0-9]*$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Local Account Number"
},
"organization_name": {
"anyOf": [
{
"maxLength": 140,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Organization Name"
},
"organization_number": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Organization Number"
},
"description": {
"anyOf": [
{
"maxLength": 255,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"kid_type": {
"anyOf": [
{
"$ref": "#/$defs/KidTypeEnum"
},
{
"type": "null"
}
],
"default": null
}
},
"title": "BankAccountSchema",
"type": "object"
},
"BarCodeSchema": {
"properties": {
"value": {
"description": "The identifier as a string",
"title": "Value",
"type": "string"
},
"type": {
"description": "Type of the identifier. Can be either \"SKU\" or a Global Trade Item Number (GTIN) type like \"UPC\", \"EAN\", \"GS1\".",
"title": "Type",
"type": "string"
}
},
"required": [
"value",
"type"
],
"title": "BarCodeSchema",
"type": "object"
},
"CountryCodeEnum": {
"enum": [
"AD",
"AE",
"AL",
"AM",
"AO",
"AR",
"AT",
"AU",
"AZ",
"BA",
"BB",
"BD",
"BE",
"BF",
"BG",
"BH",
"BI",
"BJ",
"BN",
"BO",
"BR",
"BS",
"BW",
"CA",
"CG",
"CH",
"CL",
"CM",
"CO",
"CR",
"CY",
"CZ",
"DE",
"DJ",
"DK",
"DO",
"DZ",
"EC",
"EE",
"EG",
"ES",
"ET",
"FI",
"FJ",
"FR",
"GA",
"GB",
"GE",
"GH",
"GN",
"GQ",
"GR",
"GT",
"GY",
"HN",
"HR",
"HT",
"HU",
"ID",
"IE",
"IL",
"IN",
"IQ",
"IS",
"IT",
"JM",
"JO",
"JP",
"KE",
"KG",
"KH",
"KR",
"KW",
"KZ",
"LA",
"LB",
"LI",
"LK",
"LT",
"LU",
"LV",
"LR",
"MA",
"MC",
"MD",
"ME",
"MG",
"MK",
"MN",
"MR",
"MT",
"MU",
"MV",
"MW",
"MX",
"MY",
"MZ",
"NA",
"NE",
"NG",
"NL",
"NO",
"NP",
"NZ",
"OM",
"PA",
"PE",
"PG",
"PH",
"PK",
"PL",
"PT",
"PY",
"QA",
"RO",
"RS",
"RW",
"SA",
"SE",
"SG",
"SI",
"SK",
"SL",
"SN",
"SR",
"SV",
"SZ",
"TD",
"TG",
"TH",
"TJ",
"TM",
"TN",
"TR",
"TT",
"TZ",
"UA",
"UG",
"US",
"UY",
"UZ",
"VN",
"ZA",
"ZM"
],
"title": "CountryCodeEnum",
"type": "string"
},
"CreateAddressRequestSchema": {
"properties": {
"organization_name": {
"title": "Organization Name",
"type": "string"
},
"street_address": {
"maxLength": 255,
"title": "Street Address",
"type": "string"
},
"country": {
"$ref": "#/$defs/CountryCodeEnum"
},
"postal_code": {
"title": "Postal Code",
"type": "string"
},
"city": {
"title": "City",
"type": "string"
},
"region": {
"default": "",
"title": "Region",
"type": "string"
}
},
"required": [
"organization_name",
"street_address",
"country",
"postal_code",
"city"
],
"title": "CreateAddressRequestSchema",
"type": "object"
},
"CurrencyEnum": {
"enum": [
"CHF",
"CZK",
"DKK",
"EUR",
"GBP",
"INR",
"MXN",
"NOK",
"PLN",
"RON",
"SEK",
"USD"
],
"title": "CurrencyEnum",
"type": "string"
},
"DeliveryMethodEnum": {
"description": "Enum for types of shipping methods",
"enum": [
"PICKUP_STORE",
"PICKUP_POINT",
"DELIVERED_TO_SHIPPING_ADDRESS",
"DELIVERED_DIGITALLY",
"EXPRESS_PICKUP_POINT",
"EXPRESS_SHIPPING_ADDRESS",
"OTHER"
],
"title": "DeliveryMethodEnum",
"type": "string"
},
"DueDateCalculationScheme": {
"description": "Scheme for calculating invoice due dates for orders.\nWhen set, modifies the due_in_days calculation based on the scheme type.",
"enum": [
"END_OF_MONTH",
"END_OF_WEEK"
],
"title": "DueDateCalculationScheme",
"type": "string"
},
"InvoiceDetailsRequestSchema": {
"properties": {
"payee": {
"anyOf": [
{
"$ref": "#/$defs/BankAccountSchema"
},
{
"type": "null"
}
],
"default": null
},
"payment_reference": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Payment Reference"
},
"payment_reference_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Payment Reference Type"
},
"payment_reference_message": {
"default": "",
"description": "Text that will be attached to the payment in order for the merchant to reconcile the payment.",
"title": "Payment Reference Message",
"type": "string"
},
"payment_reference_ocr": {
"default": "",
"description": "A string of numbers that will be attached to the payment in order for the merchant to reconcile the payment. E.g. \"KID-nummer\" in Norway.",
"title": "Payment Reference Ocr",
"type": "string"
},
"payment_status": {
"anyOf": [
{
"$ref": "#/$defs/PaymentStatusEnum"
},
{
"type": "null"
}
],
"default": null
},
"due_in_days": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"deprecated": true,
"description": "Please add terms to order instead, with type NET_TERMS and duration_days",
"title": "Due In Days"
},
"invoice_number": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Invoice Number"
},
"invoice_issue_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Invoice Issue Date"
},
"due_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Due Date"
},
"invoice_emails": {
"anyOf": [
{
"items": {
"format": "email",
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "We will send invoices to all of the email addresses.",
"title": "Invoice Emails"
}
},
"title": "InvoiceDetailsRequestSchema",
"type": "object"
},
"KidTypeEnum": {
"enum": [
"MOD_10",
"MOD_11",
"NONE"
],
"title": "KidTypeEnum",
"type": "string"
},
"LineItemRequestSchema": {
"properties": {
"name": {
"description": "Short name of the product",
"title": "Name",
"type": "string"
},
"description": {
"description": "Longer product description",
"title": "Description",
"type": "string"
},
"line_item_reference": {
"anyOf": [
{
"minLength": 1,
"pattern": "^[0-9A-Za-z_-]*$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Your line item reference",
"title": "Line Item Reference"
},
"discount_amount": {
"default": "0.00",
"description": "Discount applied to line item (defaults to 0.0), excluded tax",
"format": "decimal",
"pattern": "^-?[0-9]+(\\.[0-9]{0,2})?",
"title": "Discount Amount",
"type": "string"
},
"gross_amount": {
"description": "net_amount + tax_amount",
"format": "decimal",
"pattern": "^-?[0-9]+(\\.[0-9]{0,2})?",
"title": "Gross Amount",
"type": "string"
},
"net_amount": {
"description": "(quantity * unit_price) - discount_amount",
"format": "decimal",
"pattern": "^-?[0-9]+(\\.[0-9]{0,2})?",
"title": "Net Amount",
"type": "string"
},
"quantity": {
"description": "Number of units for the specific line item (up to 8 decimal places)",
"format": "decimal",
"pattern": "^-?[0-9]+(\\.[0-9]{0,8})?",
"title": "Quantity",
"type": "string"
},
"unit_price": {
"description": "The price of one unit excluding tax and discount (up to 6 decimal places)",
"format": "decimal",
"pattern": "^-?[0-9]+(\\.[0-9]{0,6})?",
"title": "Unit Price",
"type": "string"
},
"tax_amount": {
"description": "net_amount * tax_rate",
"format": "decimal",
"pattern": "^-?[0-9]+(\\.[0-9]{0,2})?",
"title": "Tax Amount",
"type": "string"
},
"tax_rate": {
"description": "Tax rate on the line item level",
"format": "decimal",
"pattern": "^-?[0-9]+(\\.[0-9]{0,6})?",
"title": "Tax Rate",
"type": "string"
},
"tax_class_name": {
"description": "A description of the tax class (e.g. 'VAT 20%')",
"title": "Tax Class Name",
"type": "string"
},
"tax_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Tax code from the tax registry (e.g. 'ES_IVA_STANDARD'). When provided, it must exist in the registry and populates tax metadata for e-invoicing. The full tax rules are applied when an order is created or changed, not on an order intent. Optional: if omitted, backward-compatible defaults are used.",
"title": "Tax Code"
},
"tax_exemption_reason_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "EN 16931 / PEPPOL BT-121 exemption reason code (e.g. 'VATEX-EU-132'). Required when the tax_code's registry entry has requires_exemption_reason=True and no default exemption_reason_code is defined. When supplied, overrides the registry default.",
"title": "Tax Exemption Reason Code"
},
"quantity_unit": {
"description": "Unit like kg, l, pcs, etc.",
"title": "Quantity Unit",
"type": "string"
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Link to the image of the product.",
"title": "Image Url"
},
"product_page_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Link to the store product page.",
"title": "Product Page Url"
},
"type": {
"$ref": "#/$defs/LineItemTypeEnum",
"description": "Product type."
},
"details": {
"anyOf": [
{
"$ref": "#/$defs/ProductDetailsSchema"
},
{
"type": "null"
}
],
"default": null,
"description": "Meta-information and identifiers for the line item."
},
"prototype_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Prototype id",
"title": "Prototype Id"
},
"vendor_name": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Vendor for line item",
"title": "Vendor Name"
},
"merchant_child_order_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "In the case that the order created with Two is used to cover multiple orders on the merchant's side, this field could be referencing the merchant order that each line item originates from. This is analogous to how the merchant_order_id on the order itself can be used to map a Two order one-to-one with a merchant order. Depending on your configuration with Two, line items may be grouped by this value in the resulting invoice and the value may be rendered as a reference for each group of line items. In marketplace situations (multiple sub-vendors), this is typically combined with the vendor_name field on the line item, to indicate a vendor per child order.",
"title": "Merchant Child Order Id"
}
},
"required": [
"name",
"description",
"gross_amount",
"net_amount",
"quantity",
"unit_price",
"tax_amount",
"tax_rate",
"tax_class_name",
"quantity_unit",
"type"
],
"title": "LineItemRequestSchema",
"type": "object"
},
"LineItemTypeEnum": {
"enum": [
"DIGITAL",
"PHYSICAL",
"SHIPPING_FEE",
"GIFTCARD",
"SERVICE",
"BUYER_FEE",
"OTHER"
],
"title": "LineItemTypeEnum",
"type": "string"
},
"OrderInstalmentTerms": {
"description": "By setting these fields, a merchant can create an instalment order with the specified terms.",
"properties": {
"type": {
"const": "INSTALMENTS",
"default": "INSTALMENTS",
"title": "Type",
"type": "string"
},
"period": {
"$ref": "#/$defs/TermsPeriod",
"description": "The time between two instalments. QUARTERLY must be enabled for the merchant by Two; a quarterly order with 4 instalments is repaid over 12 months."
},
"number_of_instalments": {
"description": "The number of instalments the order will be split into.",
"exclusiveMinimum": 1,
"title": "Number Of Instalments",
"type": "integer"
}
},
"required": [
"period",
"number_of_instalments"
],
"title": "OrderInstalmentTerms",
"type": "object"
},
"OrderNetTerms": {
"description": "By setting these fields, a merchant can create an net terms order with specified terms.",
"properties": {
"type": {
"const": "NET_TERMS",
"default": "NET_TERMS",
"title": "Type",
"type": "string"
},
"duration_days": {
"exclusiveMinimum": 0,
"title": "Duration Days",
"type": "integer"
},
"duration_days_calculated_from": {
"anyOf": [
{
"$ref": "#/$defs/DueDateCalculationScheme"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional scheme for calculating the invoice due date. When set, modifies how due_in_days is calculated from the fulfillment date:\n- END_OF_MONTH: (days to end of month) + duration_days\n- END_OF_WEEK: (days to end of week, Sunday) + duration_days\nNote: Cannot be used with billing_account_id. Only specific duration_days values are allowed per scheme (typically 30, 45, 60)."
}
},
"required": [
"duration_days"
],
"title": "OrderNetTerms",
"type": "object"
},
"PaymentStatusEnum": {
"enum": [
"NOT_PAID",
"PAID",
"PARTIAL_PAYMENT",
"OVERDUE",
"IN_COLLECTIONS",
"CANCELLED",
"REFUNDED",
"PARTIAL_REFUND",
"RECOURSED",
"PARTIAL_RECOURSE"
],
"title": "PaymentStatusEnum",
"type": "string"
},
"PeriodEnum": {
"enum": [
"weekly",
"biweekly",
"monthly",
"bimonthly",
"quarterly",
"yearly"
],
"title": "PeriodEnum",
"type": "string"
},
"ProductDetailsSchema": {
"properties": {
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The brand name of the item. E.g. \"Heinz\".",
"title": "Brand"
},
"categories": {
"description": "Array of one or more product categories. E.g. [\"Studio monitors\", \"Music equipment\"]",
"items": {
"type": "string"
},
"title": "Categories",
"type": "array"
},
"barcodes": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/BarCodeSchema"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Array with Barcode objects for storing SKU, EAN, etc.",
"title": "Barcodes"
},
"part_number": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The manufacturer's part number",
"title": "Part Number"
}
},
"required": [
"categories"
],
"title": "ProductDetailsSchema",
"type": "object"
},
"RecurringDetailsSchema": {
"properties": {
"token": {
"title": "Token",
"type": "string"
},
"description": {
"title": "Description",
"type": "string"
},
"period": {
"$ref": "#/$defs/PeriodEnum"
}
},
"required": [
"token",
"description",
"period"
],
"title": "RecurringDetailsSchema",
"type": "object"
},
"ShippingDetailsSchema": {
"properties": {
"tracking_number": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Tracking Number"
},
"carrier_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Carrier Name"
},
"carrier_tracking_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Carrier Tracking Url"
},
"expected_delivery_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
# --- truncated at 32 KB (34 KB total) ---
# Full source: https://artifacts.apis.io/two/json-schema/two-edit-order-request-schema-schema.json
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/two-edit-order-request-schema"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.