Retrieve custom fields

Retrieves a schema of custom fields for the specified resource type.

SecuritySecretApiKey or JWT
Request
path Parameters
resource
required
string

Resource type string.

Enum: "customers" "payment-instruments" "subscriptions" "transactions" "websites" "products" "plans" "bump-offers"
query Parameters
limit
integer [ 0 .. 1000 ]

Limits the number of collection items to be returned.

offset
integer >= 0

Specifies the starting point within the collection of items to be returned.

Responses
200

Schema of custom fields retrieved.

Response Schema: application/json
Array
type
required
string
Type value Description
array An array of strings with up to 255 characters. Maximum size is 1000 elements.
boolean true or false value.
date String in full-date format (YYYY-MM-DD).
datetime String in date-time format (YYYY-MM-DDTHH:MM:SSZ).
integer Cardinal value of between -2^31 and 2^31-1.
number Float value. This field also accepts cardinal values which are interpreted as float.
string Regular string of up to 255 characters.
monetary A map of 3-letter currency, code, and amount. Example: {"currency": "EUR", "amount": 25.30}

Note: The type value cannot be changed.

Enum: "array" "boolean" "datetime" "integer" "number" "string" "monetary"
name
string

Name of the custom field.

description
string

Description of the custom field.

additionalSchema
any

Additional schema which adds additional values constrains.

Additional parameters which can be added according to type:

Parameter name Types Description
allowedValues string, array List of allowed values.
maxLength string Maximum allowed length of a string. A maximum length of 4000 characters can be configured. By default, this value is set to 255.
Array of objects (Self) non-empty

Related resource links.

Array (non-empty)
href
required
string

Link URL.

rel
required
string

Type of link.

Value: "self"
401

Unauthorized access. Invalid credentials used.

403

Access forbidden.

get/custom-fields/{resource}
Request samples
$customFields = $client->customFields()->search('customers', [
    'filter' => 'type:boolean',
]);
Response samples
application/json
[
  • {
    }
]