Developer Helper Endpoints

Developers working with a rich data source and platform like Mydex will want to be able to ask questions of the platform in real time to help them know what they can do and what is available.

The following functions are designed to help understand what data is available within our Master Schema, what data types, what fields and any validation rules that apply. We also provide helper functions to understand at a specific personal data store level what is available within that store.

If you have other helper functions that you feel would be of use do let us know by giving feedback using our feedback form.


Description Path/Parameters Returned data Example
View all the available datasets in the master schema database. GET /developer-helpers/datasets dataset_machine_name

dataset_name

status
/developer-helpers/datasets

[{"dataset_machine_name":"ds_address",
  "dataset_name":"Address",
  "status":"Implement"},
 {"dataset_machine_name":"ds_bank_account_transactions",
  "dataset_name":"Bank Account Transactions",
  "status":"Live"},
...]
View datasets by status. To view multiple categories, separate them by /. GET /developer-helpers/datasets/:status1/:status2/:status3 dataset_machine_name

dataset_name

status
/developer-helpers/datasets/in%20development/implement

[{"dataset_machine_name":"ds_address",
  "dataset_name":"Address",
  "status":"Implement"},
 {"dataset_machine_name":"ds_certificates",
  "dataset_name":"Certificates",
  "status":"In Development"},
...]
Display the accepted options for a particular field. GET /developer-helpers/options/:field list of options /developer-helpers/options/lu_utility_service

["Broadband",
 "Electricity",
 "Gas",
 "Gas & Electricity",
 "Oil",
 "Telephone",
 "Water"]
Get the data types of all fields in a dataset. GET /developer-helpers/types/:dataset field_name

display_name

data_type
/developer-helpers/types/field_ds_employment

{"field_emp_employee_id":
  {"field_name":"field_emp_employee_id",
   "display_name":"EmployeeID",
   "data_type":"text"},
 "field_emp_employer_name":
  {"field_name":"field_emp_employer_name",
   "display_name":"Employer Name",
   "data_type":"text"},
...}
Get the data type of a specific field. GET /developer-helpers/type/:field field_name

display_name

data_type
/developer-helpers/type/ba_transaction_date

{"field_name":"ba_transaction_date",
 "display_name":"Transactions Date",
 "data_type":"date"}
Lists linked groups with corresponding linked fields. GET /developer-helpers/linkedfields linked_group_name

field_name
/developer-helpers/linkedfields

{"Birth Town":
 ["field_birth_town",  
  "field_dl_pob",
  "field_pp_place_of_birth"],
 "Country":
 ["field_home_country",
  "field_utility_billing_country",
  "field_utility_supplied_country"],
...}
Find all fields belonging to a linked group. GET /developer-helpers/linkedfieldsgroup/:groupname field_name

dataset_machine_name
/developer-helpers/linkedfieldsgroup/first%20name

[{"field_name":"field_personal_fname",
  "dataset_machine_name":"field_ds_personal_details"},
 {"field_name":"field_pp_given_names",
  "dataset_machine_name":"field_ds_passport"}]
Find the linked group a specific field belongs to and view all fields in this group. GET /developer-helpers/linkedfields/:field linked_group_name

linked_fields
/developer-helpers/linkedfields/field_birth_dob

{"linked_group_name":"Date of Birth",
 "linked_fields":
  ["field_birth_dob", 
   "field_dl_dob",
   "field_pp_dob"]}
Find field names that include the search term. GET /developer-helpers/search/:search search term

matching fields
/developer-helpers/search/birth

{"search_term":"birth",
 "matching_fields":
  ["field_birth_country",
   "field_birth_dob",
   "field_birth_nationality",
   "field_birth_town",
   "field_pp_place_of_birth"]}
Validate user input by type. GET /developer-helpers/validate/:field_name/:user_input true/false /developer-helpers/validate/field_ni_number/AB010203Z

{"result":"true"}
Validate user input for lookup field options. GET /developer-helpers/validateoptions/:lu_field_name/:user_input true/false /developer-helpers/validateoptions/lu_bank_acc_type/savingss

{"result":"false"}
Find ‘lu_’ field name for a field. GET /developer-helpers/getlookup/:field_name lu_name /developer-helpers/getlookup/field_edu_type

{"lookup_class":"lu_edu_org_type"}
Get information about PDS tabs. GET /developer-helpers/tabs/details/:names_orders/:var tab names

associated side tabs

orders of side tabs
/developer-helpers/tabs/details/names/top

{"top_tab_names":
  ["Assets","Education",
   "Employment",
   "Financial",
   "Health",
   "Home",
   "My Council",
   "Notepad",
   "Personal",
   "Personal Directory",
   "Travel",
   "Voluntary"]}
/developer-helpers/tabs/details/orders/all

[...
  {"top_tab_name":"Financial",
   "assoc_side_tabs":
    [{"order":"1",
      "side_tab_name":"Bank Account"},
     {"order":"2",
      "side_tab_name":"Credit Card"},
     {"order":"3",
      "side_tab_name":"Loyalty Card"}]},
  {"top_tab_name":"Health",
   "assoc_side_tabs":
    [{"order":"1",
      "side_tab_name":"Basics"}]},
...]
Get information about fields within tabs. GET /developer-helpers/tabs/layout/:top_tab/:side_tab panel name

field_name

order

dataset_machine_name
/developer-helpers/tabs/layout/Personal/Basics

{"panel_name":"Personal-Basics",
 "panel_type":"Linear",
 "items":
  [{"order":"1",
    "dataset_machine_name":"field_ds_personal_details",
    "field_name":"field_personal_title"},
   {"order":"2",
    "dataset_machine_name":"field_ds_personal_details",
    "field_name":"field_personal_fname"},
...]}