Get a single custom field

Content

Resource URL

https://apps.ticketmatic.com/api/1/{accountname}/settings/system/customfields/{id}

Example

Request

1use Ticketmatic\Endpoints\Settings\System\Customfields;
2
3$result = Customfields::get($client, $id);

Response

 1object(\Ticketmatic\Model\CustomField) (13) {
 2  ["id"]=>
 3  int(0)
 4  ["typeid"]=>
 5  int(0)
 6  ["availability"]=>
 7  object(\Ticketmatic\Model\CustomfieldAvailability) (2) {
 8    ["saleschannels"]=>
 9    array(1) {
10      [0]=>
11      int(0)
12    }
13    ["usescript"]=>
14    bool(false)
15  }
16  ["caption"]=>
17  string(5) "Genre"
18  ["description"]=>
19  string(29) "Where have you heard from us?"
20  ["edittypeid"]=>
21  int(0)
22  ["fieldtypeid"]=>
23  int(0)
24  ["key"]=>
25  string(5) "genre"
26  ["manualsort"]=>
27  bool(false)
28  ["requiredtypeid"]=>
29  int(0)
30  ["isarchived"]=>
31  bool(false)
32  ["createdts"]=>
33  object(\DateTime) (3) {
34    ["date"]=>
35    string(26) "2014-09-26 15:24:36.000000"
36    ["timezone_type"]=>
37    int(3)
38    ["timezone"]=>
39    string(3) "UTC"
40  }
41  ["lastupdatets"]=>
42  object(\DateTime) (3) {
43    ["date"]=>
44    string(26) "2014-09-26 15:24:36.000000"
45    ["timezone_type"]=>
46    int(3)
47    ["timezone"]=>
48    string(3) "UTC"
49  }
50}
51

Request

1import (
2    "github.com/ticketmatic/tm-go/ticketmatic"
3    "github.com/ticketmatic/tm-go/ticketmatic/settings/system/customfields"
4)
5
6result, err := customfields.Get(client, id)

Response

 1result := &ticketmatic.CustomField{
 2    Id: 123,
 3    Typeid: 13001,
 4    Availability: &ticketmatic.CustomfieldAvailability{
 5        Saleschannels: []int64{
 6            14,
 7        },
 8        Usescript: false,
 9    },
10    Caption: "Genre",
11    Description: "Where have you heard from us?",
12    Edittypeid: 22002,
13    Fieldtypeid: 12001,
14    Key: "genre",
15    Manualsort: false,
16    Requiredtypeid: 30002,
17    Isarchived: false,
18    Createdts: ticketmatic.NewTime(ticketmatic.MustParseTime("2014-09-26 15:24:36")),
19    Lastupdatets: ticketmatic.NewTime(ticketmatic.MustParseTime("2014-09-26 15:24:36")),
20}

Request

1GET /api/1/{accountname}/settings/system/customfields/{id} HTTP/1.1

Response

 1HTTP/1.1 200 OK
 2Content-Type: application/json
 3
 4{
 5    "id": 123,
 6    "typeid": 13001,
 7    "availability": {
 8        "saleschannels": [ 14 ],
 9        "usescript": false
10    },
11    "caption": "Genre",
12    "description": "Where have you heard from us?",
13    "edittypeid": 22002,
14    "fieldtypeid": 12001,
15    "key": "genre",
16    "manualsort": false,
17    "requiredtypeid": 30002,
18    "isarchived": false,
19    "createdts": "2014-09-26 15:24:36",
20    "lastupdatets": "2014-09-26 15:24:36"
21}

Result fields

FieldDescription
id
int

Unique ID

Example value:123
typeid
int

Type ID

Example value:13001
availability

Rules that define in what conditions this custom field is available when edit type is checkout

Example value:{ "saleschannels": [ 14 ], "usescript": false }
caption

Human-readable name for the custom field

Example value:"Genre"
description

Human-readable description for the custom field. Will be visible for end-users when edittype checkout is used

Example value:"Where have you heard from us?"
edittypeid
int

Type of editing that is allowed for the custom field. Links to systemtype category 22xxx

Example value:22002
fieldtypeid
int

Type of the custom field. Links to systemtype category 12xxx

Example value:12001
key
string

The identifier for the custom field. Should contain only alphanumeric characters and no whitespace, max length is 30 characters. The custom field will be available in the api and the public data model as c_

Example value:"genre"
manualsort
bool

Indicated whether the field is manually sortable

requiredtypeid
int

Indicates where the custom field is required. Links to systemtype category 30xxx

Example value:30002
isarchived
bool

Whether or not this item is archived

createdts
timestamp

Created timestamp

Example value:"2014-09-26 15:24:36"
lastupdatets
timestamp

Last updated timestamp

Example value:"2014-09-26 15:24:36"

Type reference: CustomField