Initial commit for the CCB API Client.

The client currently supports the following APIs:

* individual_profiles
* individual_profile_from_id
* individual_profile_from_login_password
* individual_profile_from_micr
* custom_field_labels

22 files changed, 1480 insertions, 0 deletions

diff --git a/src/main/java/com/p4square/ccbapi/model/Address.java b/src/main/java/com/p4square/ccbapi/model/Address.java
new file mode 100644
index 0000000..9bbd6e3
--- /dev/null
+++ b/src/main/java/com/p4square/ccbapi/model/Address.java
@@ -0,0 +1,125 @@
+package com.p4square.ccbapi.model;
+
+import javax.xml.bind.annotation.*;
+
+/**
+ * Representation of a United States postal address.
+ */
+@XmlRootElement(name="address")
+@XmlAccessorType(XmlAccessType.NONE)
+public class Address {
+    @XmlType(namespace="Address")
+    public enum Type {
+        @XmlEnumValue("mailing") MAILING,
+        @XmlEnumValue("home") HOME,
+        @XmlEnumValue("work") WORK,
+        @XmlEnumValue("other") OTHER;
+    }
+
+    @XmlAttribute(name="type")
+    private Type type;
+
+    @XmlElement(name="street_address")
+    private String streetAddress;
+
+    @XmlElement(name="city")
+    private String city;
+
+    @XmlElement(name="state")
+    private String state;
+
+    @XmlElement(name="zip")
+    private String zip;
+
+    @XmlElement(name="country")
+    private Country country;
+
+    @XmlElement(name="line_1")
+    private String line_1;
+
+    @XmlElement(name="line_2")
+    private String line_2;
+
+    @XmlElement(name="latitude")
+    private String latitude;
+
+    @XmlElement(name="longitude")
+    private String longitude;
+
+    public Type getType() {
+        return type;
+    }
+
+    public void setType(Type type) {
+        this.type = type;
+    }
+
+    public String getStreetAddress() {
+        return streetAddress;
+    }
+
+    public void setStreetAddress(String streetAddress) {
+        this.streetAddress = streetAddress;
+        updateAddressLines();
+    }
+
+    public String getCity() {
+        return city;
+    }
+
+    public void setCity(String city) {
+        this.city = city;
+        updateAddressLines();
+    }
+
+    public String getState() {
+        return state;
+    }
+
+    public void setState(String state) {
+        if (state.length() < 2 || state.length() > 3) {
+            throw new IllegalArgumentException("Invalid state code.");
+        }
+        this.state = state.toUpperCase();
+        updateAddressLines();
+    }
+
+    public String getZip() {
+        return zip;
+    }
+
+    public void setZip(String zip) {
+        this.zip = zip;
+        updateAddressLines();
+    }
+
+    public Country getCountry() {
+        return country;
+    }
+
+    public void setCountry(Country country) {
+        this.country = country;
+        updateAddressLines();
+    }
+
+    public String getLine_1() {
+        return line_1;
+    }
+
+    public String getLine_2() {
+        return line_2;
+    }
+
+    public String getLatitude() {
+        return latitude;
+    }
+
+    public String getLongitude() {
+        return longitude;
+    }
+
+    private void updateAddressLines() {
+        this.line_1 = streetAddress;
+        this.line_2 = String.format("%s, %s %s", city, state, zip);
+    }
+}
diff --git a/src/main/java/com/p4square/ccbapi/model/CCBAPIResponse.java b/src/main/java/com/p4square/ccbapi/model/CCBAPIResponse.java
new file mode 100644
index 0000000..d54c8a9
--- /dev/null
+++ b/src/main/java/com/p4square/ccbapi/model/CCBAPIResponse.java
@@ -0,0 +1,35 @@
+package com.p4square.ccbapi.model;
+
+import com.p4square.ccbapi.model.CCBErrorResponse;
+
+import javax.xml.bind.annotation.XmlElement;
+import javax.xml.bind.annotation.XmlElementWrapper;
+import java.util.List;
+
+/**
+ * Base class for all responses from the CCB API.
+ */
+public abstract class CCBAPIResponse {
+
+    @XmlElementWrapper(name="errors", nillable=true)
+    @XmlElement(name="error")
+    private List<CCBErrorResponse> errorResponses;
+
+    /**
+     * Return the error message if present.
+     *
+     * @return A CCBErrorResponse if an error occurred. Null if the request was successful.
+     */
+    public List<CCBErrorResponse> getErrors() {
+        return errorResponses;
+    }
+
+    /**
+     * Set the error response.
+     *
+     * @param error The CCBErrorResponse to set.
+     */
+    public void setErrors(final List<CCBErrorResponse> errors) {
+        this.errorResponses = errors;
+    }
+}
diff --git a/src/main/java/com/p4square/ccbapi/model/CCBErrorResponse.java b/src/main/java/com/p4square/ccbapi/model/CCBErrorResponse.java
new file mode 100644
index 0000000..7fb1948
--- /dev/null
+++ b/src/main/java/com/p4square/ccbapi/model/CCBErrorResponse.java
@@ -0,0 +1,48 @@
+package com.p4square.ccbapi.model;
+
+import javax.xml.bind.annotation.*;
+
+/**
+ * Representation of an error response returned by CCB.
+ */
+@XmlRootElement(name="error")
+@XmlAccessorType(XmlAccessType.NONE)
+public class CCBErrorResponse {
+    @XmlAttribute
+    private int number;
+
+    @XmlAttribute
+    private String type;
+
+    @XmlValue
+    private String description;
+
+    public int getNumber() {
+        return number;
+    }
+
+    public void setNumber(int number) {
+        this.number = number;
+    }
+
+    public String getType() {
+        return type;
+    }
+
+    public void setType(String type) {
+        this.type = type;
+    }
+
+    public String getDescription() {
+        return description;
+    }
+
+    public void setDescription(String description) {
+        this.description = description;
+    }
+
+    @Override
+    public String toString() {
+        return String.format("%03d %s Error: %s", getNumber(), getType(), getDescription());
+    }
+}
diff --git a/src/main/java/com/p4square/ccbapi/model/Country.java b/src/main/java/com/p4square/ccbapi/model/Country.java
new file mode 100644
index 0000000..e6936a5
--- /dev/null
+++ b/src/main/java/com/p4square/ccbapi/model/Country.java
@@ -0,0 +1,48 @@
+package com.p4square.ccbapi.model;
+
+import javax.xml.bind.annotation.*;
+
+/**
+ * Country code and name pair.
+ */
+@XmlRootElement(name="country")
+@XmlAccessorType(XmlAccessType.NONE)
+public class Country {
+
+    @XmlAttribute(name="code")
+    private String code;
+
+    @XmlValue
+    private String name;
+
+    /**
+     * @return The two letter country code.
+     */
+    public String getCountryCode() {
+        return code;
+    }
+
+    /**
+     * Set the two letter country code.
+     *
+     * This class does not attempt to resolve the country name from the country code.
+     * When the country code is set the name will become null.
+
+     * @param code A two letter countey code.
+     * @throws IllegalArgumentException if the country code is not valid.
+     */
+    public void setCountryCode(final String code) {
+        if (code.length() != 2) {
+            throw new IllegalArgumentException("Argument must be a two letter country code.");
+        }
+        this.code = code.toUpperCase();
+        this.name = null;
+    }
+
+    /**
+     * @return The country name or null if the country name is unknown.
+     */
+    public String getName() {
+        return name;
+    }
+}
diff --git a/src/main/java/com/p4square/ccbapi/model/CustomDateFieldValue.java b/src/main/java/com/p4square/ccbapi/model/CustomDateFieldValue.java
new file mode 100644
index 0000000..01436b7
--- /dev/null
+++ b/src/main/java/com/p4square/ccbapi/model/CustomDateFieldValue.java
@@ -0,0 +1,24 @@
+package com.p4square.ccbapi.model;
+
+import javax.xml.bind.annotation.XmlAccessType;
+import javax.xml.bind.annotation.XmlAccessorType;
+import javax.xml.bind.annotation.XmlElement;
+import java.time.LocalDate;
+
+/**
+ * A user-defined date field and the associated value.
+ */
+@XmlAccessorType(XmlAccessType.NONE)
+public class CustomDateFieldValue extends CustomField {
+
+    @XmlElement(name="date")
+    private LocalDate date;
+
+    public LocalDate getDate() {
+        return date;
+    }
+
+    public void setDate(final LocalDate date) {
+        this.date = date;
+    }
+}
diff --git a/src/main/java/com/p4square/ccbapi/model/CustomField.java b/src/main/java/com/p4square/ccbapi/model/CustomField.java
new file mode 100644
index 0000000..c9917e4
--- /dev/null
+++ b/src/main/java/com/p4square/ccbapi/model/CustomField.java
@@ -0,0 +1,74 @@
+package com.p4square.ccbapi.model;
+
+import javax.xml.bind.annotation.XmlAccessType;
+import javax.xml.bind.annotation.XmlAccessorType;
+import javax.xml.bind.annotation.XmlElement;
+import javax.xml.bind.annotation.XmlRootElement;
+
+/**
+ * Representation of a Custom/User Defined Field.
+ */
+@XmlRootElement(name="custom_field")
+@XmlAccessorType(XmlAccessType.PROPERTY)
+public class CustomField {
+    private String name;
+    private String label;
+    private boolean adminOnly;
+
+    /**
+     * Create an empty CustomField object.
+     */
+    public CustomField() {
+        // Default constructor
+    }
+
+    /**
+     * Create a CustomField object with the name and label set.
+     *
+     * adminOnly will be false by default.
+     *
+     * @param name The CustomField name.
+     * @param label The CustomField label.
+     */
+    public CustomField(final String name, final String label) {
+        this(name, label, false);
+    }
+
+    /**
+     * Create a CustomField object with the name, label, and adminOnly fields set.
+     *
+     * @param name The CustomField name.
+     * @param label The CustomField label.
+     * @param adminOnly The value of the adminOnly field.
+     */
+    public CustomField(final String name, final String label, final boolean adminOnly) {
+        this.name = name;
+        this.label = label;
+        this.adminOnly = adminOnly;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    public String getLabel() {
+        return label;
+    }
+
+    public void setLabel(String label) {
+        this.label = label;
+    }
+
+    public boolean isAdminOnly() {
+        return adminOnly;
+    }
+
+    @XmlElement(name="admin_only")
+    public void setAdminOnly(boolean adminOnly) {
+        this.adminOnly = adminOnly;
+    }
+}
diff --git a/src/main/java/com/p4square/ccbapi/model/CustomFieldCollection.java b/src/main/java/com/p4square/ccbapi/model/CustomFieldCollection.java
new file mode 100644
index 0000000..0a1f87d
--- /dev/null
+++ b/src/main/java/com/p4square/ccbapi/model/CustomFieldCollection.java
@@ -0,0 +1,137 @@
+package com.p4square.ccbapi.model;
+
+import java.util.*;
+
+/**
+ * A collection of CustomField derivatives with indexes to find a custom field and value by either name or label.
+ *
+ * This collection will only ever contain one value for any given name or label.
+ */
+public class CustomFieldCollection<T extends CustomField> implements Collection<T> {
+
+    private final List<T> values;
+    private final Map<String, T> fieldLabelToValue;
+    private final Map<String, T> fieldNameToValue;
+
+    public CustomFieldCollection() {
+        this.values = new ArrayList<>();
+        this.fieldLabelToValue = new HashMap<>();
+        this.fieldNameToValue = new HashMap<>();
+    }
+
+    /**
+     * Return the entry with given name (e.g. "udf_text_1").
+     *
+     * @param name A CCB field name.
+     * @return The entry associated with the field.
+     */
+    public T getByName(final String name) {
+        return fieldNameToValue.get(name);
+    }
+
+    /**
+     * Return the entry with given label (e.g. "Favorite Book").
+     *
+     * @param label A CCB field label.
+     * @return The entry associated with the field.
+     */
+    public T getByLabel(final String label) {
+        return fieldLabelToValue.get(label);
+    }
+
+    public List<T> asList() {
+        return Collections.unmodifiableList(values);
+    }
+
+    @Override
+    public int size() {
+        return values.size();
+    }
+
+    @Override
+    public boolean isEmpty() {
+        return values.isEmpty();
+    }
+
+    @Override
+    public boolean contains(final Object o) {
+        return values.contains(o);
+    }
+
+    @Override
+    public Iterator<T> iterator() {
+        return values.iterator();
+    }
+
+    @Override
+    public Object[] toArray() {
+        return values.toArray();
+    }
+
+    @Override
+    public <T1> T1[] toArray(final T1[] a) {
+        return values.toArray(a);
+    }
+
+    @Override
+    public boolean add(final T t) {
+        // Clean up overwritten indexes.
+        final T previousValueByName = fieldNameToValue.get(t.getName());
+        if (previousValueByName != null) {
+            remove(previousValueByName);
+        }
+
+        final T previousValueByLabel = fieldLabelToValue.get(t.getLabel());
+        if (previousValueByLabel != null) {
+            remove(previousValueByLabel);
+        }
+
+        fieldNameToValue.put(t.getName(), t);
+        fieldLabelToValue.put(t.getLabel(), t);
+        return values.add(t);
+    }
+
+    @Override
+    public boolean remove(final Object o) {
+        if (values.remove(o)) {
+            final T entry = (T) o;
+            fieldNameToValue.remove(entry.getName());
+            fieldLabelToValue.remove(entry.getLabel());
+            return true;
+        }
+        return false;
+    }
+
+    @Override
+    public boolean containsAll(Collection<?> c) {
+        return values.containsAll(c);
+    }
+
+    @Override
+    public boolean addAll(final Collection<? extends T> c) {
+        boolean result = false;
+        for (T obj : c) {
+            result |= add(obj);
+        }
+        return result;
+    }
+
+    @Override
+    public boolean removeAll(final Collection<?> c) {
+        boolean result = false;
+        for (Object obj : c) {
+            result |= remove(obj);
+        }
+        return result;
+    }
+
+    @Override
+    public boolean retainAll(final Collection<?> c) {
+        throw new UnsupportedOperationException();
+    }
+
+    @Override
+    public void clear() {
+        values.clear();
+    }
+}
diff --git a/src/main/java/com/p4square/ccbapi/model/CustomPulldownFieldValue.java b/src/main/java/com/p4square/ccbapi/model/CustomPulldownFieldValue.java
new file mode 100644
index 0000000..02a962f
--- /dev/null
+++ b/src/main/java/com/p4square/ccbapi/model/CustomPulldownFieldValue.java
@@ -0,0 +1,23 @@
+package com.p4square.ccbapi.model;
+
+import javax.xml.bind.annotation.XmlAccessType;
+import javax.xml.bind.annotation.XmlAccessorType;
+import javax.xml.bind.annotation.XmlElement;
+
+/**
+ * A user-defined pulldown field and the associated value.
+ */
+@XmlAccessorType(XmlAccessType.NONE)
+public class CustomPulldownFieldValue extends CustomField {
+
+    @XmlElement(name="selection")
+    private PulldownSelection selection;
+
+    public PulldownSelection getSelection() {
+        return selection;
+    }
+
+    public void setSelection(final PulldownSelection selection) {
+        this.selection = selection;
+    }
+}
diff --git a/src/main/java/com/p4square/ccbapi/model/CustomTextFieldValue.java b/src/main/java/com/p4square/ccbapi/model/CustomTextFieldValue.java
new file mode 100644
index 0000000..71595e3
--- /dev/null
+++ b/src/main/java/com/p4square/ccbapi/model/CustomTextFieldValue.java
@@ -0,0 +1,23 @@
+package com.p4square.ccbapi.model;
+
+import javax.xml.bind.annotation.XmlAccessType;
+import javax.xml.bind.annotation.XmlAccessorType;
+import javax.xml.bind.annotation.XmlElement;
+
+/**
+ * A user-defined text field and the associated value.
+ */
+@XmlAccessorType(XmlAccessType.NONE)
+public class CustomTextFieldValue extends CustomField {
+
+    @XmlElement(name="text")
+    private String text;
+
+    public String getText() {
+        return text;
+    }
+
+    public void setText(final String text) {
+        this.text = text;
+    }
+}
diff --git a/src/main/java/com/p4square/ccbapi/model/FamilyMemberReference.java b/src/main/java/com/p4square/ccbapi/model/FamilyMemberReference.java
new file mode 100644
index 0000000..212426c
--- /dev/null
+++ b/src/main/java/com/p4square/ccbapi/model/FamilyMemberReference.java
@@ -0,0 +1,34 @@
+package com.p4square.ccbapi.model;
+
+import javax.xml.bind.annotation.XmlAccessType;
+import javax.xml.bind.annotation.XmlAccessorType;
+import javax.xml.bind.annotation.XmlElement;
+
+/**
+ * Reference to a family member.
+ */
+@XmlAccessorType(XmlAccessType.NONE)
+public class FamilyMemberReference {
+
+    @XmlElement(name="individual")
+    private IndividualReference individualReference;
+
+    @XmlElement(name="family_position")
+    private FamilyPosition familyPosition;
+
+    public IndividualReference getIndividualReference() {
+        return individualReference;
+    }
+
+    public void setIndividualReference(IndividualReference individualReference) {
+        this.individualReference = individualReference;
+    }
+
+    public FamilyPosition getFamilyPosition() {
+        return familyPosition;
+    }
+
+    public void setFamilyPosition(FamilyPosition familyPosition) {
+        this.familyPosition = familyPosition;
+    }
+}
diff --git a/src/main/java/com/p4square/ccbapi/model/FamilyPosition.java b/src/main/java/com/p4square/ccbapi/model/FamilyPosition.java
new file mode 100644
index 0000000..ecd1e37
--- /dev/null
+++ b/src/main/java/com/p4square/ccbapi/model/FamilyPosition.java
@@ -0,0 +1,26 @@
+package com.p4square.ccbapi.model;
+
+import javax.xml.bind.annotation.XmlEnumValue;
+
+/**
+ * Enumeration of the supported values for the family_position field of an IndividualProfile.
+ */
+public enum FamilyPosition {
+    @XmlEnumValue("Primary Contact") PRIMARY_CONTACT("h"),
+    @XmlEnumValue("Spouse") SPOUSE("s"),
+    @XmlEnumValue("Child") CHILD("c"),
+    @XmlEnumValue("Other") OTHER("o");
+
+    private final String code;
+
+    FamilyPosition(String code) {
+        this.code = code;
+    }
+
+    /**
+     * @return A one character string representing the enum value.
+     */
+    public String getCode() {
+        return this.code;
+    }
+}
diff --git a/src/main/java/com/p4square/ccbapi/model/FamilyReference.java b/src/main/java/com/p4square/ccbapi/model/FamilyReference.java
new file mode 100644
index 0000000..0af220b
--- /dev/null
+++ b/src/main/java/com/p4square/ccbapi/model/FamilyReference.java
@@ -0,0 +1,34 @@
+package com.p4square.ccbapi.model;
+
+import javax.xml.bind.annotation.XmlAccessType;
+import javax.xml.bind.annotation.XmlAccessorType;
+import javax.xml.bind.annotation.XmlAttribute;
+import javax.xml.bind.annotation.XmlValue;
+
+/**
+ * Reference to an family by id and name.
+ */
+@XmlAccessorType(XmlAccessType.NONE)
+public class FamilyReference {
+    @XmlAttribute(name="id")
+    private int familyId;
+
+    @XmlValue
+    private String name;
+
+    public int getFamilyId() {
+        return familyId;
+    }
+
+    public void setFamilyId(int familyId) {
+        this.familyId = familyId;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+}
diff --git a/src/main/java/com/p4square/ccbapi/model/Gender.java b/src/main/java/com/p4square/ccbapi/model/Gender.java
new file mode 100644
index 0000000..eabaa42
--- /dev/null
+++ b/src/main/java/com/p4square/ccbapi/model/Gender.java
@@ -0,0 +1,24 @@
+package com.p4square.ccbapi.model;
+
+import javax.xml.bind.annotation.XmlEnumValue;
+
+/**
+ * Enum representing the gender of an individual in CCB.
+ */
+public enum Gender {
+    @XmlEnumValue("M") MALE("M"),
+    @XmlEnumValue("F") FEMALE("F");
+
+    private final String code;
+
+    Gender(String code) {
+        this.code = code;
+    }
+
+    /**
+     * @return A one character string representing the enum value.
+     */
+    public String getCode() {
+        return this.code;
+    }
+}
diff --git a/src/main/java/com/p4square/ccbapi/model/GetCustomFieldLabelsResponse.java b/src/main/java/com/p4square/ccbapi/model/GetCustomFieldLabelsResponse.java
new file mode 100644
index 0000000..9f56036
--- /dev/null
+++ b/src/main/java/com/p4square/ccbapi/model/GetCustomFieldLabelsResponse.java
@@ -0,0 +1,37 @@
+package com.p4square.ccbapi.model;
+
+import javax.xml.bind.annotation.*;
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * GetCustomFieldLabelsResponse models the response returned by the custom_field_labels API.
+ */
+@XmlRootElement(name="response")
+@XmlAccessorType(XmlAccessType.NONE)
+public class GetCustomFieldLabelsResponse extends CCBAPIResponse {
+
+    @XmlElementWrapper(name = "custom_fields")
+    @XmlElement(name="custom_field")
+    private List<CustomField> customFields;
+
+    public GetCustomFieldLabelsResponse() {
+        customFields = new ArrayList<>();
+    }
+
+    /**
+     * @return The list of custom field names and labels.
+     */
+    public List<CustomField> getCustomFields() {
+        return customFields;
+    }
+
+    /**
+     * Set the list of custom fields.
+     *
+     * @param fields The list to include in the response.
+     */
+    public void setCustomFields(final List<CustomField> fields) {
+        this.customFields = fields;
+    }
+}
diff --git a/src/main/java/com/p4square/ccbapi/model/GetIndividualProfilesRequest.java b/src/main/java/com/p4square/ccbapi/model/GetIndividualProfilesRequest.java
new file mode 100644
index 0000000..589de3c
--- /dev/null
+++ b/src/main/java/com/p4square/ccbapi/model/GetIndividualProfilesRequest.java
@@ -0,0 +1,159 @@
+package com.p4square.ccbapi.model;
+
+import java.time.LocalDate;
+
+/**
+ * GetIndividualProfilesRequest is the set of options for retrieving individual profiles.
+ */
+public class GetIndividualProfilesRequest {
+
+    // Used with individual_profiles
+    private LocalDate modifiedSince;
+    private Boolean includeInactive;
+    private int page;
+    private int perPage;
+
+    // Used with individual_profile_from_id
+    private int id;
+
+    // Used with individual_profile_from_login_password
+    private String login;
+    private String password;
+
+    // Used with individual_profile_from_micr
+    private String routingNumber;
+    private String accountNumber;
+
+    public int getId() {
+        return id;
+    }
+
+    /**
+     * Request the IndividualProfile for the given individual id.
+     *
+     * This option is mutually exclusive with {@link #withLoginPassword(String, String)}
+     * and {@link #withMICR(String, String)}.
+     *
+     * @param id The id.
+     * @return this.
+     */
+    public GetIndividualProfilesRequest withIndividualId(final int id) {
+        this.id = id;
+        this.login = this.password = this.accountNumber = this.routingNumber = null;
+        return this;
+    }
+
+    public String getLogin() {
+        return login;
+    }
+
+    public String getPassword() {
+        return password;
+    }
+
+    /**
+     * Request the IndividualProfile for the given login and password.
+     *
+     * This option is mutually exclusive with {@link #withIndividualId(int)}
+     * and {@link #withMICR(String, String)}.
+     *
+     * @param login The individual's login.
+     * @param password The individual's password.
+     * @return this.
+     */
+    public GetIndividualProfilesRequest withLoginPassword(final String login, final String password) {
+        this.login = login;
+        this.password = password;
+        this.id = 0;
+        this.accountNumber = this.routingNumber = null;
+        return this;
+    }
+
+    public String getRoutingNumber() {
+        return routingNumber;
+    }
+
+    public String getAccountNumber() {
+        return accountNumber;
+    }
+
+    /**
+     * Request the IndividualProfile for the given bank account information.
+     *
+     * This option is mutually exclusive with {@link #withIndividualId(int)}
+     * and {@link #withLoginPassword(String, String)}.
+     *
+     * @param routingNumber The individual's bank routing number.
+     * @param accountNumber The individual's bank account number.
+     * @return this.
+     */
+    public GetIndividualProfilesRequest withMICR(final String routingNumber, final String accountNumber) {
+        this.routingNumber = routingNumber;
+        this.accountNumber = accountNumber;
+        return this;
+    }
+
+    public LocalDate getModifiedSince() {
+        return modifiedSince;
+    }
+
+    /**
+     * Request only IndividualProfiles modified since a given date.
+     *
+     * This option is only applicable when requesting all individuals.
+     *
+     * @param modifiedSince The date.
+     * @return this.
+     */
+    public GetIndividualProfilesRequest withModifiedSince(final LocalDate modifiedSince) {
+        this.modifiedSince = modifiedSince;
+        return this;
+    }
+
+    public Boolean getIncludeInactive() {
+        return includeInactive;
+    }
+
+    public GetIndividualProfilesRequest withIncludeInactive(final boolean includeInactive) {
+        this.includeInactive = includeInactive;
+        return this;
+    }
+
+    public int getPage() {
+        return page;
+    }
+
+    /**
+     * Select the page of results when perPage is also specified.
+     *
+     * This option is only applicable when requesting all individuals.
+     *
+     * Defaults to 1 if {@link #withPerPage(int)} is specified on the request.
+     *
+     * @param page The starting page number.
+     * @return this.
+     */
+    public GetIndividualProfilesRequest withPage(final int page) {
+        this.page = page;
+        return this;
+    }
+
+    public int getPerPage() {
+        return perPage;
+    }
+
+    /**
+     * Limit the number of IndividualProfiles returned.
+     *
+     * This option is only applicable when requesting all individuals.
+     *
+     * Defaults to 25 if {@link #withPage(int)} is specified on the request.
+     *
+     * @param perPage The maximum number to return.
+     * @return this.
+     */
+    public GetIndividualProfilesRequest withPerPage(int perPage) {
+        this.perPage = perPage;
+        return this;
+    }
+}
diff --git a/src/main/java/com/p4square/ccbapi/model/GetIndividualProfilesResponse.java b/src/main/java/com/p4square/ccbapi/model/GetIndividualProfilesResponse.java
new file mode 100644
index 0000000..f88bcf7
--- /dev/null
+++ b/src/main/java/com/p4square/ccbapi/model/GetIndividualProfilesResponse.java
@@ -0,0 +1,27 @@
+package com.p4square.ccbapi.model;
+
+import javax.xml.bind.annotation.*;
+import java.util.List;
+
+/**
+ * GetCustomFieldLabelsResponse models the response of a variety of APIs which return one or more Individual Profiles.
+ */
+@XmlRootElement(name="response")
+@XmlAccessorType(XmlAccessType.NONE)
+public class GetIndividualProfilesResponse extends CCBAPIResponse {
+
+    @XmlElementWrapper(name = "individuals")
+    @XmlElement(name="individual")
+    private List<IndividualProfile> individuals;
+
+    /**
+     * @return The list of individuals retrieved from CCB.
+     */
+    public List<IndividualProfile> getIndividuals() {
+        return individuals;
+    }
+
+    public void setIndividuals(List<IndividualProfile> individuals) {
+        this.individuals = individuals;
+    }
+}
diff --git a/src/main/java/com/p4square/ccbapi/model/IndividualProfile.java b/src/main/java/com/p4square/ccbapi/model/IndividualProfile.java
new file mode 100644
index 0000000..114d071
--- /dev/null
+++ b/src/main/java/com/p4square/ccbapi/model/IndividualProfile.java
@@ -0,0 +1,449 @@
+package com.p4square.ccbapi.model;
+
+import javax.xml.bind.annotation.*;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * Representation of a Individual Profile.
+ */
+@XmlRootElement(name="individual")
+@XmlAccessorType(XmlAccessType.NONE)
+public class IndividualProfile {
+
+    @XmlAttribute(name="id")
+    private int id;
+
+    @XmlElement(name="other_id")
+    private int otherId;
+
+    @XmlElement(name="sync_id")
+    private int syncId;
+
+    @XmlElement(name="giving_number")
+    private String givingNumber;
+
+    @XmlElement(name="active")
+    private boolean active;
+
+    @XmlElement(name="first_name")
+    private String firstName;
+
+    @XmlElement(name="last_name")
+    private String lastName;
+
+    @XmlElement(name="middle_name")
+    private String middleName;
+
+    @XmlElement(name="legal_first_name")
+    private String legalFirstName;
+
+    @XmlElement(name="full_name")
+    private String fullName;
+
+    @XmlElement(name="salutation")
+    private String salutation;
+
+    @XmlElement(name="suffix")
+    private String suffix;
+
+    @XmlElement(name="image")
+    private String imageUrl;
+
+    @XmlElement(name="family_position", defaultValue = "Primary Contact")
+    private FamilyPosition familyPosition;
+
+    @XmlElement(name="family")
+    private FamilyReference family;
+
+    @XmlElement(name="family_image")
+    private String familyImageUrl;
+
+    @XmlElementWrapper(name="family_members")
+    @XmlElement(name="family_member")
+    private List<FamilyMemberReference> familyMembers;
+
+    @XmlElement(name="email")
+    private String email;
+
+    @XmlElement(name="login")
+    private String login;
+
+    @XmlElement(name="allergies")
+    private String allergies;
+
+    @XmlElement(name="confirmed_no_allergies")
+    private boolean confirmedNoAllergies;
+
+    @XmlElement(name="gender")
+    private Gender gender;
+
+    @XmlElement(name="marital_status", defaultValue="")
+    private MaritalStatus maritalStatus;
+
+    @XmlElement(name="birthday")
+    private LocalDate birthday;
+
+    @XmlElement(name="anniversary")
+    private LocalDate anniversary;
+
+    @XmlElement(name="deceased")
+    private LocalDate deceased;
+
+    @XmlElement(name="membership_date")
+    private LocalDate membershipStartDate;
+
+    @XmlElement(name="membership_end")
+    private LocalDate membershipEndDate;
+
+    @XmlElement(name="baptized")
+    private boolean baptized;
+
+    @XmlElement(name="creator")
+    private IndividualReference createdBy;
+
+    @XmlElement(name="created")
+    private LocalDateTime createdTime;
+
+    @XmlElement(name="modifier")
+    private IndividualReference modifiedBy;
+
+    @XmlElement(name="modified")
+    private LocalDateTime modifiedTime;
+
+    @XmlElementWrapper(name="addresses")
+    @XmlElement(name="address")
+    private List<Address> addresses;
+
+    @XmlElementWrapper(name="phones")
+    @XmlElement(name="phone")
+    private List<Phone> phones;
+
+    @XmlElementWrapper(name="user_defined_text_fields")
+    @XmlElement(name="user_defined_text_field")
+    private CustomFieldCollection<CustomTextFieldValue> customTextFields;
+
+    @XmlElementWrapper(name="user_defined_date_fields")
+    @XmlElement(name="user_defined_date_field")
+    private CustomFieldCollection<CustomDateFieldValue> customDateFields;
+
+    @XmlElementWrapper(name="user_defined_pulldown_fields")
+    @XmlElement(name="user_defined_pulldown_field")
+    private CustomFieldCollection<CustomPulldownFieldValue> customPulldownFields;
+
+    public IndividualProfile() {
+        familyMembers = new ArrayList<>();
+        addresses = new ArrayList<>();
+        phones = new ArrayList<>();
+        customTextFields = new CustomFieldCollection<>();
+        customDateFields = new CustomFieldCollection<>();
+        customPulldownFields = new CustomFieldCollection<>();
+    }
+
+    public int getId() {
+        return id;
+    }
+
+    public void setId(int id) {
+        this.id = id;
+    }
+
+    public int getOtherId() {
+        return otherId;
+    }
+
+    public IndividualProfile setOtherId(int otherId) {
+        this.otherId = otherId;
+        return this;
+    }
+
+    public int getSyncId() {
+        return syncId;
+    }
+
+    public void setSyncId(int syncId) {
+        this.syncId = syncId;
+    }
+
+    public String getGivingNumber() {
+        return givingNumber;
+    }
+
+    public void setGivingNumber(String givingNumber) {
+        this.givingNumber = givingNumber;
+    }
+
+    public boolean isActive() {
+        return active;
+    }
+
+    public void setActive(boolean active) {
+        this.active = active;
+    }
+
+    public String getFirstName() {
+        return firstName;
+    }
+
+    public void setFirstName(String firstName) {
+        this.firstName = firstName;
+    }
+
+    public String getLastName() {
+        return lastName;
+    }
+
+    public void setLastName(String lastName) {
+        this.lastName = lastName;
+    }
+
+    public String getMiddleName() {
+        return middleName;
+    }
+
+    public void setMiddleName(String middleName) {
+        this.middleName = middleName;
+    }
+
+    public String getLegalFirstName() {
+        return legalFirstName;
+    }
+
+    public void setLegalFirstName(String legalFirstName) {
+        this.legalFirstName = legalFirstName;
+    }
+
+    public String getFullName() {
+        return fullName;
+    }
+
+    public void setFullName(String fullName) {
+        this.fullName = fullName;
+    }
+
+    public String getSalutation() {
+        return salutation;
+    }
+
+    public void setSalutation(String salutation) {
+        this.salutation = salutation;
+    }
+
+    public String getSuffix() {
+        return suffix;
+    }
+
+    public void setSuffix(String suffix) {
+        this.suffix = suffix;
+    }
+
+    public String getImageUrl() {
+        return imageUrl;
+    }
+
+    public void setImageUrl(String imageUrl) {
+        this.imageUrl = imageUrl;
+    }
+
+    public FamilyPosition getFamilyPosition() {
+        return familyPosition;
+    }
+
+    public void setFamilyPosition(FamilyPosition familyPosition) {
+        this.familyPosition = familyPosition;
+    }
+
+    public FamilyReference getFamily() {
+        return family;
+    }
+
+    public void setFamily(FamilyReference family) {
+        this.family = family;
+    }
+
+    public String getFamilyImageUrl() {
+        return familyImageUrl;
+    }
+
+    public void setFamilyImageUrl(String familyImageUrl) {
+        this.familyImageUrl = familyImageUrl;
+    }
+
+    public List<FamilyMemberReference> getFamilyMembers() {
+        return familyMembers;
+    }
+
+    public void setFamilyMembers(List<FamilyMemberReference> familyMembers) {
+        this.familyMembers = familyMembers;
+    }
+
+    public String getEmail() {
+        return email;
+    }
+
+    public void setEmail(String email) {
+        this.email = email;
+    }
+
+    public String getLogin() {
+        return login;
+    }
+
+    public void setLogin(String login) {
+        this.login = login;
+    }
+
+    public String getAllergies() {
+        return allergies;
+    }
+
+    public void setAllergies(String allergies) {
+        this.allergies = allergies;
+    }
+
+    public boolean isConfirmedNoAllergies() {
+        return confirmedNoAllergies;
+    }
+
+    public void setConfirmedNoAllergies(boolean confirmedNoAllergies) {
+        this.confirmedNoAllergies = confirmedNoAllergies;
+    }
+
+    public Gender getGender() {
+        return gender;
+    }
+
+    public void setGender(Gender gender) {
+        this.gender = gender;
+    }
+
+    public MaritalStatus getMaritalStatus() {
+        return maritalStatus;
+    }
+
+    public void setMaritalStatus(MaritalStatus maritalStatus) {
+        this.maritalStatus = maritalStatus;
+    }
+
+    public LocalDate getBirthday() {
+        return birthday;
+    }
+
+    public void setBirthday(LocalDate birthday) {
+        this.birthday = birthday;
+    }
+
+    public LocalDate getAnniversary() {
+        return anniversary;
+    }
+
+    public void setAnniversary(LocalDate anniversary) {
+        this.anniversary = anniversary;
+    }
+
+    public LocalDate getDeceased() {
+        return deceased;
+    }
+
+    public void setDeceased(LocalDate deceased) {
+        this.deceased = deceased;
+    }
+
+    public LocalDate getMembershipStartDate() {
+        return membershipStartDate;
+    }
+
+    public void setMembershipStartDate(LocalDate membershipStartDate) {
+        this.membershipStartDate = membershipStartDate;
+    }
+
+    public LocalDate getMembershipEndDate() {
+        return membershipEndDate;
+    }
+
+    public void setMembershipEndDate(LocalDate membershipEndDate) {
+        this.membershipEndDate = membershipEndDate;
+    }
+
+    public boolean isBaptized() {
+        return baptized;
+    }
+
+    public void setBaptized(boolean baptized) {
+        this.baptized = baptized;
+    }
+
+    public IndividualReference getCreatedBy() {
+        return createdBy;
+    }
+
+    public void setCreatedBy(IndividualReference createdBy) {
+        this.createdBy = createdBy;
+    }
+
+    public LocalDateTime getCreatedTime() {
+        return createdTime;
+    }
+
+    public void setCreatedTime(LocalDateTime createdTime) {
+        this.createdTime = createdTime;
+    }
+
+    public IndividualReference getModifiedBy() {
+        return modifiedBy;
+    }
+
+    public void setModifiedBy(IndividualReference modifiedBy) {
+        this.modifiedBy = modifiedBy;
+    }
+
+    public LocalDateTime getModifiedTime() {
+        return modifiedTime;
+    }
+
+    public void setModifiedTime(LocalDateTime modifiedTime) {
+        this.modifiedTime = modifiedTime;
+    }
+
+    public List<Address> getAddresses() {
+        return addresses;
+    }
+
+    public void setAddresses(List<Address> addresses) {
+        this.addresses = addresses;
+    }
+
+    public List<Phone> getPhones() {
+        return phones;
+    }
+
+    public void setPhones(List<Phone> phones) {
+        this.phones = phones;
+    }
+
+    public CustomFieldCollection<CustomTextFieldValue> getCustomTextFields() {
+        return customTextFields;
+    }
+
+    public void setCustomTextFields(CustomFieldCollection<CustomTextFieldValue> customTextFields) {
+        this.customTextFields = customTextFields;
+    }
+
+    public CustomFieldCollection<CustomDateFieldValue> getCustomDateFields() {
+        return customDateFields;
+    }
+
+    public void setCustomDateFields(CustomFieldCollection<CustomDateFieldValue> customDateFields) {
+        this.customDateFields = customDateFields;
+    }
+
+    public CustomFieldCollection<CustomPulldownFieldValue> getCustomPulldownFields() {
+        return customPulldownFields;
+    }
+
+    public void setCustomPulldownFields(CustomFieldCollection<CustomPulldownFieldValue> customPulldownFields) {
+        this.customPulldownFields = customPulldownFields;
+    }
+}
diff --git a/src/main/java/com/p4square/ccbapi/model/IndividualReference.java b/src/main/java/com/p4square/ccbapi/model/IndividualReference.java
new file mode 100644
index 0000000..1b25b90
--- /dev/null
+++ b/src/main/java/com/p4square/ccbapi/model/IndividualReference.java
@@ -0,0 +1,34 @@
+package com.p4square.ccbapi.model;
+
+import javax.xml.bind.annotation.XmlAccessType;
+import javax.xml.bind.annotation.XmlAccessorType;
+import javax.xml.bind.annotation.XmlAttribute;
+import javax.xml.bind.annotation.XmlValue;
+
+/**
+ * Reference to an individual by id and name.
+ */
+@XmlAccessorType(XmlAccessType.NONE)
+public class IndividualReference {
+    @XmlAttribute(name="id")
+    private int individualId;
+
+    @XmlValue
+    private String name;
+
+    public int getIndividualId() {
+        return individualId;
+    }
+
+    public void setIndividualId(int individualId) {
+        this.individualId = individualId;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+}
diff --git a/src/main/java/com/p4square/ccbapi/model/MaritalStatus.java b/src/main/java/com/p4square/ccbapi/model/MaritalStatus.java
new file mode 100644
index 0000000..d9e5921
--- /dev/null
+++ b/src/main/java/com/p4square/ccbapi/model/MaritalStatus.java
@@ -0,0 +1,28 @@
+package com.p4square.ccbapi.model;
+
+import javax.xml.bind.annotation.XmlEnumValue;
+
+/**
+ * Enumeration of the possible values for the marital status field of an individual in CCB.
+ */
+public enum MaritalStatus {
+    @XmlEnumValue("Single") SINGLE("s"),
+    @XmlEnumValue("Married") MARRIED("m"),
+    @XmlEnumValue("Widowed") WIDOWED("w"),
+    @XmlEnumValue("Divorced") DIVORCED("d"),
+    @XmlEnumValue("Separated") SEPARATED("p"),
+    @XmlEnumValue("") NOT_SELECTED(" ");
+
+    private final String code;
+
+    MaritalStatus(String code) {
+        this.code = code;
+    }
+
+    /**
+     * @return A one character string representing the enum value.
+     */
+    public String getCode() {
+        return this.code;
+    }
+}
diff --git a/src/main/java/com/p4square/ccbapi/model/Phone.java b/src/main/java/com/p4square/ccbapi/model/Phone.java
new file mode 100644
index 0000000..eb66eb1
--- /dev/null
+++ b/src/main/java/com/p4square/ccbapi/model/Phone.java
@@ -0,0 +1,41 @@
+package com.p4square.ccbapi.model;
+
+import javax.xml.bind.annotation.*;
+
+/**
+ * Phone Number and Type pair.
+ */
+@XmlRootElement(name="phone")
+@XmlAccessorType(XmlAccessType.NONE)
+public class Phone {
+    @XmlType(namespace="Phone")
+    public enum Type {
+        @XmlEnumValue("contact") CONTACT,
+        @XmlEnumValue("home") HOME,
+        @XmlEnumValue("work") WORK,
+        @XmlEnumValue("mobile") MOBILE,
+        @XmlEnumValue("emergency") EMERGENCY;
+    }
+
+    @XmlAttribute(name="type")
+    private Type type;
+
+    @XmlValue
+    private String number;
+
+    public Type getType() {
+        return type;
+    }
+
+    public void setType(Type type) {
+        this.type = type;
+    }
+
+    public String getNumber() {
+        return number;
+    }
+
+    public void setNumber(String number) {
+        this.number = number;
+    }
+}
diff --git a/src/main/java/com/p4square/ccbapi/model/PulldownSelection.java b/src/main/java/com/p4square/ccbapi/model/PulldownSelection.java
new file mode 100644
index 0000000..d473849
--- /dev/null
+++ b/src/main/java/com/p4square/ccbapi/model/PulldownSelection.java
@@ -0,0 +1,34 @@
+package com.p4square.ccbapi.model;
+
+import javax.xml.bind.annotation.XmlAccessType;
+import javax.xml.bind.annotation.XmlAccessorType;
+import javax.xml.bind.annotation.XmlAttribute;
+import javax.xml.bind.annotation.XmlValue;
+
+/**
+ * A pull down field option.
+ */
+@XmlAccessorType(XmlAccessType.NONE)
+public class PulldownSelection {
+    @XmlAttribute(name="id")
+    private int id;
+
+    @XmlValue
+    private String label;
+
+    public int getId() {
+        return id;
+    }
+
+    public void setId(final int id) {
+        this.id = id;
+    }
+
+    public String getLabel() {
+        return label;
+    }
+
+    public void setLabel(final String label) {
+        this.label = label;
+    }
+}
diff --git a/src/main/java/com/p4square/ccbapi/model/package-info.java b/src/main/java/com/p4square/ccbapi/model/package-info.java
new file mode 100644
index 0000000..154bded
--- /dev/null
+++ b/src/main/java/com/p4square/ccbapi/model/package-info.java
@@ -0,0 +1,16 @@
+/**
+ * This package contains models for CCB API requests and responses.
+ */
+@XmlJavaTypeAdapters({
+        @XmlJavaTypeAdapter(type=LocalDate.class, value=LocalDateXmlAdapter.class),
+        @XmlJavaTypeAdapter(type=LocalDateTime.class, value=LocalDateTimeXmlAdapter.class),
+})
+package com.p4square.ccbapi.model;
+
+import com.p4square.ccbapi.LocalDateTimeXmlAdapter;
+import com.p4square.ccbapi.LocalDateXmlAdapter;
+
+import javax.xml.bind.annotation.adapters.XmlJavaTypeAdapter;
+import javax.xml.bind.annotation.adapters.XmlJavaTypeAdapters;
+import java.time.LocalDate;
+import java.time.LocalDateTime;