• Technology | Matchbox System Overview
  • Matchbox API
  • Security

Matchbox, Inc. provides Software-as-a-Service (SaaS) via a scalable and high-security cloud-based architecture delivered to web and mobile device clients.

The Matchbox Admissions Systems consists of a role-based distribution system built using the latest in advanced web services.

AdmitPad currently uses established cloud-hosting providers Amazon and Rackspace to deliver the Matchbox software services. Both providers are certified SAS70 Type II, PCI Level 1, and HIPAA, and are the market leaders in secure, high-availability cloud-hosting services.

Platforms

At present, the only client available to users is an Apple iOS software bundle on the Apple iPad.

Systems Integration

  • Online Application
  • ApplyYourself
  • Common Application
  • CollegeNET
  • Symplicity
  • Peoplesoft Campus
  • Student Information
  • Oracle / Peoplesoft Campus
  • Banner
  • Matrix
  • CRM Systems
  • Salesforce
  • Saleslogix
  • Intelliworks

Application States

An application in AdmitPad correlates to an application for admission, or an application from an online application vendor such as ApplyYourself. Applications may automatically be uploaded from your vendor platform if we have configured the connectivity.

Create an Application

POST /api/v1/application/

PARAMETERS

details

Dictionary of the fields configured to be accepted by your program

email

Applicant email

first_name

First name of applicant

middle_name

Middle name of applicant

last_name

Last name of applicant

external_id

The ID used by your source system or system of record, commonly the ayapplicantid from ApplyYourself

Request

{
  "details": {
    "accepted_online": "N",
    "citizenship_country": "USA",
    "current_phone": "6175555555",
    "degree_1_college_country": "USA",
    "degree_1_college_name": "AdmitPad University",
    "degree_1_from_date": "1/1/2000",
    "degree_1_to_date": "12/1/2004",
    "dob": "1/1/1950",
    "employer_1_name": "Google",
    "employer_1_title": "CEO",
    "gender": "F",
    "gmat": "700",
  },
  "email": "tester@google.com",
  "external_id": "312123131",
  "first_name": "Andrew",
  "last_name": "Synthesize",
  "middle_name": "",
  "name_prefix": "Mr.",
  "name_suffix": "",
}

Update an Application

PUT /api/v1/application/(id)/

The update request only needs to submit the fields that were changed or modified.

Request

{
"id":"4e779522a53ea7322b00000f"
"last_name": "Testerson",
}

Get Application Details

GET /api/v1/application/(id)/

Returns the application’s information in AdmitPad. This data is not modified within Matchbox and is only pushed from your server, but this API can be used as a reference to validate the values have been pushed correctly from your source system.

Response

{
  “details”: {
    “accepted_online”: ”N”,
    “citizenship_country”: ”USA”,
    “current_phone”: ”6175555555″,
    “degree_1_college_country”: ”USA”,
    “degree_1_college_name”: ”AdmitPad University”,
    “degree_1_from_date”: ”1/1/2000″,
    “degree_1_to_date”: ”12/1/2004″,
    “dob”: ”1/1/1950″,
    “employer_1_name”: ”Google”,
    “employer_1_title”: ”CEO”,
    “gender”: ”F”,
    “gmat”: ”700″,
  },
  “email”: ”tester@google.com”,
  “external_id”: ”312123131″,
  “first_name”: ”Andrew”,
  “id”: ”4e5e439da53dd7888d000018″,
  “last_name”: ”Synthesize”,
  “middle_name”: ”",
  “name_prefix”: ”Mr.”,
  “name_suffix”: ”",
}

Get Application List

GET /api/v1/application/

Returns the list of available application information in AdmitPad. The results are paginated by 20 per page. To retrieve additional pages use the querystring parameter “?page=2”.

Response

{
  “meta”: {
    “limit”: 20,
    “next”: null,
    “offset”: 0,
    “previous”: null,
    “total_count”: 1
  },
  “objects”: [
    {
      "details": {
      "applying_to_other_harvard": "N",
      "citizenship_country": "V60",
      "current_phone": "986776818",
      "degree_1_college_country": "Vietnam",
      "degree_1_college_name": "Polytechnical University in Hanoi",
      "degree_1_from_date": "9/1/1979",
      "degree_1_to_date": "9/1/1984",
      "dob": "12/21/62",
      "employer_1_name": "Hatexco Hanoi Vietnam",
      "employer_1_title": "manager in production",
      "gender": "M",
      "gmat": "896",
      "previous": "Y",
      "reapplicant": "Y",
      "specialization": "STR",
      "us_resident": "N"
    },
    "email": "franktankmucciarone@hotmail.com",
    "external_id": "2143161",
    "first_name": "Frank",
    "id": "4e5e439da53ea7888d000018",
    "last_name": "Mucciarone",
    "middle_name": "Tank",
    "name_prefix": "Mr.",
    "name_suffix": "",
    "password": "",
    "pdf": "uploads/application_None/AdmitPad%20disguised%20applications
            %20Houjun.pdf",
    "pdf_hash": null,
    "resource_uri": "/api/v1/application/4e5e439da53ea7888d000018/",
    "status": ""
    }
  ]
}

Applicants

An application in AdmitPad correlates to an application for admission, or an application from an online application vendor such as ApplyYourself. Applications may automatically be uploaded from your vendor platform if we have configured the connectivity.

Create an Application

POST /api/v1/application/

PARAMETERS

details

Dictionary of the fields configured to be accepted by your program

email

Applicant email

first_name

First name of applicant

middle_name

Middle name of applicant

last_name

Last name of applicant

external_id

The ID used by your source system or system of record, commonly the ayapplicantid from ApplyYourself

Request

{
  "details": {
    "accepted_online": "N",
    "citizenship_country": "USA",
    "current_phone": "6175555555",
    "degree_1_college_country": "USA",
    "degree_1_college_name": "AdmitPad University",
    "degree_1_from_date": "1/1/2000",
    "degree_1_to_date": "12/1/2004",
    "dob": "1/1/1950",
    "employer_1_name": "Google",
    "employer_1_title": "CEO",
    "gender": "F",
    "gmat": "700",
  },
  "email": "tester@google.com",
  "external_id": "312123131",
  "first_name": "Andrew",
  "last_name": "Synthesize",
  "middle_name": "",
  "name_prefix": "Mr.",
  "name_suffix": "",
}

Update an Application

PUT /api/v1/application/(id)/

The update request only needs to submit the fields that were changed or modified.

Request

{
"id":"4e779522a53ea7322b00000f"
"last_name": "Testerson",
}

Get Application Details

GET /api/v1/application/(id)/

Returns the application’s information in AdmitPad. This data is not modified within Matchbox and is only pushed from your server, but this API can be used as a reference to validate the values have been pushed correctly from your source system.

Response

{
  “details”: {
    “accepted_online”: ”N”,
    “citizenship_country”: ”USA”,
    “current_phone”: ”6175555555″,
    “degree_1_college_country”: ”USA”,
    “degree_1_college_name”: ”AdmitPad University”,
    “degree_1_from_date”: ”1/1/2000″,
    “degree_1_to_date”: ”12/1/2004″,
    “dob”: ”1/1/1950″,
    “employer_1_name”: ”Google”,
    “employer_1_title”: ”CEO”,
    “gender”: ”F”,
    “gmat”: ”700″,
  },
  “email”: ”tester@google.com”,
  “external_id”: ”312123131″,
  “first_name”: ”Andrew”,
  “id”: ”4e5e439da53dd7888d000018″,
  “last_name”: ”Synthesize”,
  “middle_name”: ”",
  “name_prefix”: ”Mr.”,
  “name_suffix”: ”",
}

Get Application List

GET /api/v1/application/

Returns the list of available application information in AdmitPad. The results are paginated by 20 per page. To retrieve additional pages use the querystring parameter “?page=2”.

Response

{
  “meta”: {
    “limit”: 20,
    “next”: null,
    “offset”: 0,
    “previous”: null,
    “total_count”: 1
  },
  “objects”: [
    {
      "details": {
      "applying_to_other_harvard": "N",
      "citizenship_country": "V60",
      "current_phone": "986776818",
      "degree_1_college_country": "Vietnam",
      "degree_1_college_name": "Polytechnical University in Hanoi",
      "degree_1_from_date": "9/1/1979",
      "degree_1_to_date": "9/1/1984",
      "dob": "12/21/62",
      "employer_1_name": "Hatexco Hanoi Vietnam",
      "employer_1_title": "manager in production",
      "gender": "M",
      "gmat": "896",
      "previous": "Y",
      "reapplicant": "Y",
      "specialization": "STR",
      "us_resident": "N"
    },
    "email": "franktankmucciarone@hotmail.com",
    "external_id": "2143161",
    "first_name": "Frank",
    "id": "4e5e439da53ea7888d000018",
    "last_name": "Mucciarone",
    "middle_name": "Tank",
    "name_prefix": "Mr.",
    "name_suffix": "",
    "password": "",
    "pdf": "uploads/application_None/AdmitPad%20disguised%20applications
            %20Houjun.pdf",
    "pdf_hash": null,
    "resource_uri": "/api/v1/application/4e5e439da53ea7888d000018/",
    "status": ""
    }
  ]
}