Get started

doLoginPOST

Response:
{
    "aff_id": "Affiliate ID",
    "user_fname": "First name",
    "user_lname": "Last name",
    "member_cat": "Member category",
    "member_type": "Member Type / User Type",
    "paid_thru_date.sec": "Paid through date of an affiliate. i.e, Affliate membership is valid till this date. Field value is in Unix timestamp (the number of seconds since January 1 1970 00:00:00 UTC)",
    "pay_dues": "true / false This affiliate has any open billing documents to pay?",
    "org": "True / False This will let you know if affiliate is organization record or not",
    "mstatus": "Member Status Like Active/Inactive/Lapsed etc."
}

Another type of response for assistant login with multiple connection

{
	"asst_login_users": [{
		"id": 5010212,
		"fname": "John",
		"lname": "Doe",
		"email": "john.doe@gmail.com",
		"prof_pic": ""
	}, {
		"id": 5010441,
		"fname": "Smith",
		"lname": "Jones",
		"email": "smithjones@outlook.com",
		"prof_pic": ""
	}]
}

                    

resetPasswordPOST

Response:
{
    success: 1
}
                    

changePasswordGET

Response:
{
    success: 1
}
                    

verifyEmailGET

Response:
{
"existing":true,
"aff_id":5007875,
"mcat":"NM"
}
                    

superReportsGET

Response:
[
    {
        "name": "test",
        "_id": 7001,
        "mby": " ",
        "mon": "08/07/2020"
    },
    {
        "name": "Affiilates who logged in after Feb 2015",
        "_id": 7002,
        "mby": " ",
        "mon": "02/20/2015"
    }
]
                    

superReportsEngineGET

Response:
{
    "header": [
        "First Name",
        "Last Name",
        "Country"
    ],
   "result": [
        [
            "John",
            "Doe",
            "US"
        ],
        [
            "Jane",
            "P",
            "Doe"
        ]
    ],
   "count": 2 
}
                    

createActivityTypePOST

Response:
{
    act_id: 23 (integer)
}
                    

addActivityPOST

Response:
{
    "success": 1
}
                    

getActivityGET

Response:
{
    "activity": OBJECT
    "success": 1
}
                    

updateActivityPOST

Response:
{
    "success": 1
}
                    

getActivitiesGET

Response:
{
    "activity": ARRAY of OBJECTS
    "success": 1
}
                    

getActivityTypesGET

Response:
{
    "activity_types": ARRAY of OBJECTS
}
                    

deleteActivityPOST

Response:
{
    "success": 1
}
                    

getDropdownsGET

Response:
Each dropdown field will have an array of keys (Field name “k”) and values (Field name “v”). Always key should be passed to create / update user account.

For example, if user selects “Male” as his gender, then key value of Male is “M” and this should be passed to “gender” field to create / update user details.

{
  "prefix": [
    {
      "k": "Mr",
      "v": "Mr."
    },
    {
      "k": "Dr",
      "v": "Dr."
    },
    {
      "k": "Mrs",
      "v": "Mrs."
    },
}
                    

creditEduHoursPOST

Response:
{
    success: 1
}
                    

getConfRegistrationListGET

Response:
{
    registrations: Matching Registrations, Records (Array of Object),
    reg_count: Count of Matched Records (integer)
}

registrations:
{
    reg_id: Registration ID (integer),
    primary_reg_type: Primary registration type(string),
    primary_reg_type_desc: Primary registration type description(string),
    total_amt: Total amount paid(floating point),
    created_on: Created on Date(Date time string),
    paid_date: Paid on Date(Date time string),
    reg_status: Registration Status (string)
    aff_id: Affiliation ID (integer)
    prefix: prefix (string),
    fname: First name (string),
    mname: Middle name (string),
    lname: Last name (string),
    suffix: Suffix (string)
    pref_name: Preferred Name (string),
    disp_name: Disp Name (string)
    email: Email (string),
    desig: Designation (string),
    company: Company/Affiliation (string),
    jtitle: Job Title (string),
    mcat: Affiliate Category (string),
    mstatus: Affiliate Status (string),
    user_tupe: Affiliate type (string),
    pthru: Paid through date (Datetime string),
    jn_date: Join Date (Datetime string),
    add1: Address 1 (string),
    add2: Address 2 (string),
    add3: Address 3 (string),
    city: City (string),
    state: State (string),
    zip: Zip Code (string),
    country: Country (string),
    phone: Phone (string),
    reg_details: Registration Details (array of objects)
}
                    

verifyAndCheckInConfAttendeePOST

Response:
{
    reg_id: Registration ID (integer),
    reg_status: Registration status (string),
    reg_status_desc: Registration status description (string)
    checkin_timestamp: Checkin timestamp (string),
    success: Checkin status (boolean)
}
                    

getConfRegistrationInfoGET

Response:
{
    "reg_info": [
        {
            "ques": "Badge Name and Affiliation",
            "value": [
                [
                    "John",
                    "Doe",
                    "ABC INFO TECH"
                ]
            ]
        },
        {
            "ques": "Pronouns",
            "value": "He/Him/His"
        },
        {
            "ques": "Cell Phone Number",
            "value": "9999900000"
        },
        {
            "ques": "Emergency Contact",
            "value": [
                [
                    "Jane",
                    "0000099999",
                    "jane@testmail.com"
                ]
            ]
        },
        {
            "ques": "Are you a first time attendee?",
            "value": "No"
        },
        {
            "ques": "Please indicate the most appropriate descriptors of your academic work:",
            "value": "Clinical Care"
        },
        {
            "ques": "Special Dietary Needs",
            "value": "None"
        },
    ]
}
                    

getMemberDuesGET

Response:
{
    "_id": "Billing document number",
    "a_id": "Affiliate ID",
    "gross_amt": "Gross amount",
    "adj_amt": "Total discount amount",
    "adj_det": [{
        "amt": "Discount amount",
        "r": "Discount reason"
    }],
    "bill_amt": "Billed amount(Gross Amount– Discount Amount)",
    "bill_date.s": "Billed date",
    "bdate.sec": "Begin date",
    "edate.sec": "End Date",
    "o_id": "Order id",
    "p_code": "Product code “pcode” is dropdown field.Product descriptions for product codes can be fetched from getDropdowns api.",
    "pline": "Product line | Dropdown field– p_line",
    "p_grp": "Product Group | Dropdown field– p_grp",
    "p_sgrp": "Product Sub Group | Dropdown field– p_sgrp",
    "qty": "Quantity",
    "recur": "Is this recurring billing ?",
    "status": "Billing document status",
    "uom": "Currency",
    "taxes": "Array | If association has setup any tax for the membership or products applicable tax name and percentage will be sent as array of objects",
    "promo_code": "If product has any applicable promo code that can be used then this parameter will be sent as true else this parameter will not be sent",
    "secondary_aff_bills": "Array | of object(Bill Details) When primary affiliate logs in to pay member due then we give an option for them to pay all there secondary affiliates associated with affiliate"
}
                    

searchDirectoryGET

Response:
{
    "affiliates": [{
        "aff_id": "Affiliate ID",
        "fname": "First Name",
        "lname": "Last Name",
        "email": "E-mail address",
        "mcat": "Member Category",
        "company": "Company",
        "jtitle": "Job Title",
        "city": "City",
        "state": "State",
        "phone": "Phone number",
        "search_dir": "Member Search Directory Flag",
    }],
    "total_Count": "Total number of affiliate matches for given search criteria. This will be helpful in pagination."
}
                    

Affiliate ListPOST

Response:
{
    "total_num_aff": 1,
    "affiliates": [
        {
            "a_id": 5011462,
            "pref_name": "Allison",
            "lname": "Jolley",
            "dob": "03/07/1996",
            "college": "Univ of Arkansas",
            "graduation_year": 2021,
            "national_assoc": [
                "ACCP"
            ],
            "gender": "",
            "ethnicity": "",
            "ethnicity_other": "",
            "nabp_ce_id": "1164272",
            "tn_lic_no": "45267",
            "prev_last_name": null,
            "certified_tech": "",
            "pharmacy_district": "",
            "biography": "",
            "jn_date": "11/06/2023",
            "pthru": "03/05/2024",
            "con": "11/06/2023",
            "mon": "02/09/2024",
            "company": [
                {
                    "company": "St Mary's Health System, Inc.",
                    "jtitle": "Critical Care Clinical Pharmacist"
                },
                {
                    "company": "test",
                    "jtitle": "tased"
                }
            ],
            "organization": false,
            "jtitle": "tased",
            "mcat": "Pharmacist OOS Member",
            "mstatus": "Active",
            "user_type": "Member",
            "chapter": "",
            "chapter_main": "",
            "primary_aff_id": [],
            "addresses": [
                {
                    "add_type": "W",
                    "add1": "965 Glenwild Circle",
                    "add2": "",
                    "city": "Canton, MS",
                    "state": "MS",
                    "zip": "39046",
                    "country": "US",
                    "county": "",
                    "phone": "(318) 450-2504",
                    "ext": "",
                    "mobile": "(318) 450-2504",
                    "email": "allison.jolley2@gmail.com",
                    "email2": 0
                },
                {
                    "add_type": "H",
                    "add1": "",
                    "add2": "",
                    "city": "",
                    "state": "",
                    "zip": "",
                    "country": "",
                    "county": "",
                    "phone": "",
                    "mobile": "",
                    "email": "allison.jolley@fmolhs.org",
                    "email2": 0
                }
            ]
        }
    ]
}
                    

getPrimaryAffConnectionsGET

Response:
{
    "affiliates":  [
        {
            "_id": "Affiliate ID",
            "fname": "First Name",
            "lname": "Last Name",
            "email": "Email Address",
            "mcat": "Affiliate Category",
            "company": "Company Name",
            "mstatus": "Affiliate Status",
            "pthru": "Paid Through Date",
            "user_type": "Affiliate Type",
            "company_admin": "Company Admin Flag",
        }
    ],
    "count": "Total Number of Connected Affiliates"
}
                    

getUserDetailsGET

Response:
{
  "aff_details": {
    "_id": 5000002,
    "biography": "Test Biography",
    "company": "Test Company",
    "disp_name": "John Doe MD",
    "dob": {
      "sec": 45253,
      "usec": 0
    },
    "email": "john.doe@testwork.com",
    "ethnicity": "W",
    "fname": "John",
    "gender": "M",
    "invited_by": "Jane Doe",
    "jtitle": "Associate Professor, Internal Medicine",
    "l_login": {
      "sec": 1387941249,
      "usec": 418000
    },
    "lname": "Doe",
    "mname": "",
    "prefix": "Dr",
    "second_cont": {
      "fname": "Jane",
      "lname": "Doe",
      "phone": "5555566666",
      "email": "jane.doe@testwork.com",
      "prefix": "Mrs"
    },
    "user_type": "N"
  },
  "addresses": [
    {
      "_id": 7000001,
      "a_id": 5000002,
      "add1": "Test",
      "add2": "",
      "add3": "",
      "add_type": "H",
      "bill2": 1,
      "city": "Brentwood",
      "company": "",
      "country": "US",
      "county": "",
      "email": "john.doe@testemail.com",
      "email2": 1,
      "fax": "",
      "mail2": 1,
      "mobile": "",
      "phone": "",
      "ship2": 0,
      "state": "TN",
      "url": "",
      "zip": "48108"
    },
  ]
}
                    

updateUserDetailsPOST

Response:
{
    success: 1,
    aff_id: Affiliate ID
}

                    

getPaymentDetailsGET

Response:
{
    "payment_details": [{
        "_id": "Payment ID",
        "a_id": "Affiliate ID",
        "b_id": "Billing ID",
        "bdate": "Begin Date (Object)",
        "edate": "End Date (Object)",
        "p_code": "Product Code",
        "p_amt": "Paid Amount",
        "paid_date": "Paid On Date",
        "status": "Payment Status",
        "qty": "Quantity",
        "notes": "Notes",
    }],
    "edu_hrs":  1,
}
                    

getOpenOrdersGET

Response:
{
    "Field": "Description",
    "_id": "OrderID",
    "a_id": "Affiliate ID",
    "b_amt": "Billing Amount",
    "bdate": "Begin Date",
    "cby": "Created By",
    "con": "Created On",
    "edate": "End Date",
    "freq": "Frequency ",
    "uom": "Unit of Money",
    "qty": "Quantity",
    "status": "Status of the order",
    "pterms": "Payment Terms",
    "p_line": "Product Line",
    "p_grp": "Product Group",
    "p_sgrp": "Product Sub Group",
    "p_code": "Product Code",
    "o_amt": "Order Amt",
    "recur": "Recurring Flag"
}
                    

payMemberDuesPOST

Response:
{
    "paid_thru_date.sec": "Updated affiliate paid through date after payment Unix timestamp",
    "payment_ids": "Array of payment ids for the paid billing documents",
    "success": 1,
}
                    

checkOutMultipleProductPOST

Response:
{
    "bill_ids": "Array Billing Numbers",
    "bill_amt_details": [
        {
            "bill_num": "Billing Number",
            "bill_amt": "Billing Amount"
        }
    ]
}
                    

buyproductPOST

Response:
{
    "billNum":  Billing ID,
    "billAmt": "Billing Amount"
    "zero_val_bill": "True will be sent if billing amount is zero (Boolean)"
}
                    

applyPromoCodePOST

Response:
{
    "success":  Boolean,
    "msg": "Promotional Discount Applied Successfully
                or
            Required Parameters were not passed for the API.
                or
            Promo Code entered is not valid.
                or
            Selected Bill is not valid.
                or
            Promo Code already applied for selected bill."
}
                    

cancelOpenOrdersPOST

Response:
{
    success: true,
    orders_closed: Number of Orders closed (Count)
}
                    

updateOrderARBPOST

Response:
{
    "success":  1,
}
                    

linkAuthNetCustProfWithAffProfPOST

Response:
{
    success: 1
}
                    

createAuthNetSubByCustProfPOST

Response:
{
    "success": 1,
    "subscription_ids": [
        {
            "bill_id": "", 
            "subscription_id": ""
        }
    ]
}
                    

createAuthNetInstallmentByCustProfPOST

Response:
{
    "success": 1,
    "installment_id": "Installment ID"
}
                    

updateAuthNetCustProfWithAffProfPOST

Response:
{
    "success": 1
}
                    

deleteAuthNetCustProfPOST

Response:
{
    "success": 1
}
                    

Response codes and error messages

The JoynAMS API uses the following error codes