© 2018 Capita Business Services Ltd. All rights reserved.

Capita Education Software Solutions is a trading name of Capita Business Services Ltd. Our Registered office is 30 Berners Street, London, W1T 3LR and our registered number is 02299747. Further information about Capita plc can be found in our legal statement.

DeX OData - Learner | ContactContactDetails

Read is supported in DeX OData and SIMS 8 V3 APIs. 

Example Call

https://seli00apm01.azure-api.net/dex/Learner/odata/V3/LearnerContactDetails?$expand=Telephones,Addresses,Emails (DeX OData)

See here for Stem URLs for SIMS 8.

Click here for sample code

API Definition

ContactContactDetails
    {
        public Guid ExternalID;
        public string Addressee;
        public string Salutation;
        public List<TTelephoneRef> Telephones;
        public List<TEmailRef> Emails;
        public List<TContactContactDetailsAddress> Addresses;
        public List<TContactContactDetailsLearnerRelationship> LearnerRelationships;
    }
public class TContactAddressTypeRef : TReferenceClass { }
    public class TContactContactDetailsAddress 
    {
        public Guid ExternalID;
        public Nullable<DateTime> StartDate;
        public Nullable<DateTime> EndDate;
        public TAddress Address;
        public TContactAddressTypeRef AddressType;

    }
 public class TContactLearnerRelationshipTypeRef : TReferenceClass { }
    public class TContactContactDetailsLearnerDetail : TReferenceClass { }
    public class TContactContactDetailsLearnerRelationship
    {
        public Guid ExternalID;
        public Nullable<bool> HasCourtOrder;
        public Nullable<bool> HasParentalResponsibility;
        public TContactLearnerRelationshipTypeRef LearnerContactRelationshipType;
        public Nullable<int> Priority;
        public Nullable<bool> ReceivesCorrespondance;
        public Nullable<bool> ReceivesSchoolReport;
        public TContactContactDetailsLearnerDetail Learner;
    }
 public class TTelephoneRef
    {
        public Guid ExternalID;
        public string TelephoneNumber;
        public Nullable<bool> IsFirstPointOfContact;
        public Nullable<bool> UseForAutomatedMessages;
        public string Notes;
        public TLocationTypeRef LocationType;
    }
    public class TEmailRef
    {
        public Guid ExternalID;
        public string EmailAddress;
        public Nullable<bool> IsMainEmail;
        public Nullable<bool> UseForAutomatedMessages;
        public string Notes;
        public TEmailLocationTypeRef LocationType;
    }
    public class TAddress
    {
        public Guid ExternalID;
        public string Apartment;
        public string BuildingNumber;
        public string BuildingName;
        public string Street;
        public string District;
        public string Town;
        public string AdministrativeArea;
        public string Postcode;
        public string CoordinateX;
        public string CoordinateY;
        public string USRN;
        public string UPRN;
        public string AddressIdentifier;
        public Nullable<DateTime> LastValidated;
        public TCountryRef Country;
        public TResourceProviderRef ResourceProvider;
    }

Example Output


    "@odata.context": "https://seli00apm01.azure-api.net/ssli01/Learner/v3/$metadata#ContactContactDetails",
    "value": [
        {
            "ExternalID": "8071b471-356d-402e-ba32-bd8107034f36",
            "Salutation": "Mr Elverdon",
            "Addressee": "Mr G Elverdon",
            "Emails": [
                {
                    "ExternalID": "671b7760-224e-431c-b8ec-8486b26e980f",
                    "UseForAutomatedMessages": true,
                    "Notes": null,
                    "IsMainEmail": true,
                    "EmailAddress": "Elverdon@example.com",
                    "LocationType": {
                        "ExternalID": "5e9c48d2-2bb4-4496-9128-cc723c51dcc5",
                        "Type": "Learner.Lookup.EmailLocationType"
                    }
                }
            ],
            "LearnerRelationships": [
                {
                    "ExternalID": "ea292557-dac7-4bea-9b53-aea0cc42a91d",
                    "HasCourtOrder": false,
                    "HasParentalResponsibility": true,
                    "Priority": 2,
                    "ReceivesCorrespondance": false,
                    "ReceivesSchoolReport": false,
                    "LearnerContactRelationshipType": {
                        "ExternalID": "f4bdd91c-8ec2-4a86-b08c-ac4101635225",
                        "Type": "Learner.Lookup.LearnerContactRelationshipType"
                    },
                    "Learner": {
                        "ExternalID": "4cc7337a-c4b9-44e9-9893-f7bcd6079f60",
                        "Type": "Learner"
                    }
                }
            ],
            "Addresses": [
                {
                    "ExternalID": "ff8b0caa-0977-4817-9bc0-303a6890724f",
                    "StartDate": "2017-11-27T00:00:00Z",
                    "EndDate": null,
                    "Address": {
                        "Apartment": null,
                        "BuildingNumber": null,
                        "BuildingName": "The Tresses",
                        "Street": "Church End",
                        "District": "Ravensden",
                        "Town": "Bedford",
                        "AdministrativeArea": null,
                        "Postcode": "MK44 2RR",
                        "CoordinateX": "507796.0",
                        "CoordinateY": "254416.0",
                        "USRN": "27302091",
                        "UPRN": "100080992653",
                        "AddressIdentifier": null,
                        "LastValidated": null,
                        "ExternalID": "eec588d7-7cde-42b4-aa25-e0e17daf3707",
                        "Country": {
                            "ExternalID": "95096e84-bb17-459d-85f7-c8e9b3952599",
                            "Type": "Learner.Lookup.Country"
                        },
                        "ResourceProvider": {
                            "ExternalID": "0b3724b6-fcf5-41e7-badc-b71f6b1b4d9e",
                            "Type": "EducationalEstablishment"
                        }
                    },
                    "AddressType": {
                        "ExternalID": "0282b5ad-155a-4ace-8618-e85478b21132",
                        "Type": "Learner.Lookup.ContactAddressType"
                    }
                }
            ],
            "Telephones": [
                {
                    "ExternalID": "5c56e0af-52f3-4d92-a22b-6caec19e5edd",
                    "TelephoneNumber": "07333 238904",
                    "IsFirstPointOfContact": true,
                    "UseForAutomatedMessages": false,
                    "Notes": null,
                    "LocationType": {
                        "ExternalID": "f7ae272b-cce9-4bad-9818-8605db13cf29",
                        "Type": "Learner.Lookup.LocationType"
                    }
                },
                {
                    "ExternalID": "2e96b175-b265-442a-9305-e46e12479283",
                    "TelephoneNumber": "01632 443889",
                    "IsFirstPointOfContact": false,
                    "UseForAutomatedMessages": true,
                    "Notes": null,
                    "LocationType": {
                        "ExternalID": "f7ae272b-cce9-4bad-9818-8605db13cf29",
                        "Type": "Learner.Lookup.LocationType"
                    }
                }
            ]
        },