Custom Fields

Methods

Entity Properties

Additional Resources

order_custom_field.list 

order_custom_field.list ()

Retrieve list of order custom fields available for the calling merchant.

Return Value

An array of objects. Each object will contain Order Custom Field properties.

Example Request

{
    "jsonrpc" : 2.0,
    "id"      : 1234,
    "method"  : "call",
    "params"  : [
        "34aa989befe360d67fe3f70b3517a1e5",
        "order_custom_field.list"
    ]
}

Example Response

{
    "result": [
        {
            "custom_field_id": "3",
            "name": "Original Purchase Date",
            "code": "purchase_date",
            "is_active": "1",
            "input_type": "date",
            "is_required": "0",
            "client_note": null,
            "client_permissions": "restricted",
            "is_display_client_grid": "1",
            "is_display_client_form": "0",
            "sort_order": "0",
            "created_at": "2022-07-01T10:46:16+00:00",
            "updated_at": "2022-07-01T10:46:16+00:00"
        },
        {
            "custom_field_id": "4",
            "name": "Main Item SKU",
            "code": "main_sku",
            "is_active": "1",
            "input_type": "text",
            "is_required": "0",
            "client_note": null,
            "client_permissions": "unrestricted",
            "is_display_client_grid": "0",
            "is_display_client_form": "1",
            "sort_order": "99",
            "created_at": "2022-07-01T11:43:28+00:00",
            "updated_at": "2022-07-01T11:43:28+00:00"
        }
    ],
    "id": "1234",
    "jsonrpc": "2.0"
}

Entity Properties

Order Custom Field Properties

custom_field_id 
{ "custom_field_id" : 1 }
An automatically generated unique identifier for an Order Custom Field.
name 
{ "name" : "Main Item SKU" }
The "name" property.
code 
{ "code" : "main_sku" }
The "code" property.
is_active 
{ "is_active" : 1 }
Flag whether Order Custom Field is active.
input_type 
{ "input_type" : "multiselect" }
The "input_type" property. Allowed values: "text", "multiline-text", "number", "currency", "select", "multiselect", "boolean", "date", "client-user", "admin-user", "email", "url".
is_required 
{ "is_required" : 1 }
Flag whether Order Custom Field is required.
client_note 
{ "client_note" : "Warranty Claim Reason" }
The "client_note" property.
client_permissions 
{ "client_permissions" : "unrestricted" }
The "unrestricted" property. Allowed values: "unrestricted", "restricted", "read-only", "hidden".
is_display_client_grid 
{ "is_display_client_grid" : 1 }
Flag whether Order Custom Field is displayed in the client grid.
is_display_client_form 
{ "is_display_client_form" : 1 }
Flag whether Order Custom Field is displayed in the client form.
sort_order 
{ "sort_order" : 0 }
The "sort_order" property.
created_at 
{ "created_at" : "2022-12-15T13:47:47+00:00" }
The "Created At" property.
updated_at 
{ "updated_at" : "2022-12-15T13:47:47+00:00" }
The "Updated At" property.
options Array of options. See "Option Properties".

Order Custom Field Option Properties

option_id 
{ "option_id" : 2 }
The internal option ID.
label 
{ "label" : "Red" }
The "Label" property.
is_default 
{ "is_default" : 1 }
Flag whether option is default.
sort_order 
{ "sort_order" : 5 }
The "Sort Order" property.