Get order extra fields

Get all available information about extra fields saved to an order.

📘

Access scopes required: read_orders

Headers

NameTypeDescription
AuthorizationstringoAuth token with mandatory Bearer before it. Example: Bearer e***s0, where e***s0 should be replaced with your oAuth token.

Response

A JSON object of type 'orderExtraFields' with the following fields:

orderExtraFields

FieldTypeDescription
idstringExtra field's key
valuestringExtra field's value
customerInputTypestringSupported values: TEXT, TEXTAREA, SELECT, CHECKBOX, TOGGLE_BUTTON_GROUP, RADIO_BUTTONS, DATETIME, LABEL. More on this in [Types of fields] (add-new-fields-to-checkout#types-of-fields) section
titlestringTitle of an extra field that prompts the user to enter the value
orderDetailsDisplaySectionstringDefines the order section the extra field values is shown to customer and merchant. Supported values: shipping_info, billing_info, customer_info, order_comments. More on this in Show extra fields in an order section.
orderBystringExtra field position at an order section in Ecwid Control Panel. The smaller the number, the higher the position is.
showInNotificationsbooleanIf not specified the default value is false. Set true to show extra field in order emails. orderDetailsDisplaySection sets the part where the extra field will appear.
showInInvoicebooleantrue/false if the extra field should be displayed in order invoice or not

Errors

Error response example:

HTTP/1.1 404 Not Found
Content-Type application/json; charset=utf-8

In case of error, Ecwid responds with an error HTTP status code and, optionally, JSON-formatted body containing error description

HTTP codes

HTTP StatusDescription
400Request parameters are malformed
403Access token doesn't have read_orders scope
404Order or extra field is not found
405Method not allowed. Can occur when using POST instead of PUT HTTP request method
415Unsupported content-type: expected application/json or text/json
500Cannot retrieve extra fields info because of an error on the server

Error response body (optional)

FieldTypeDescription
errorMessagestringError message
Language
Authorization
Query