EventPoint API REST Reference

In order to use the EventPoint API, you must have an apikey. All requests must include code and an apikey values. You may include these parameters in the querystring or in the headers.

Results are either JSON or XML. If no format is specified, JSON is returned. To specify an XML response, supply a paramter format=xml

Please replace the version number where /vn.n is specified. Current version is 2.3

JSONP is supported. Append a callback parameter with the value of the function that call you want to wrap the result in.

All date/times are now formatted in ISO 8601 format

Name Description Required
code Your event's unique code Yes
apikey Your API access key Yes
format Response format. May be "json" or "xml" No

Summary of Available Services

Below are all the available services

Retrieving Program Data

Program

http://api.eventpoint.com/n.n/program

Response data
{
    "id":"ff6f772b-1449-df11-850f-001ec953730b",
    "code":"yourcode",
    "name":"Your Event 2011",
    "url":"yourcode.eventpoint.com",
    "startdate":"2012-02-15T00:00:00Z",
    "enddate":"2012-02-15T00:00:00Z",
    "timezoneid":"Pacific Standard Time",
    "timezoneoffset":-4,
    "days":null,
    "categories":null,
    "topics":null,
    "timeslots":null,
    "rooms":null,
    "speakers":null
    "agenda":null
}
    

Topics

http://api.eventpoint.com/n.n/program/topics

Topics are wrapped in a result that specifies the topic results, current page, the page size, and the total number of topics returned. This service will let you query topics based on a variety of parameters, as noted below.

Name Description Required
page The page to return. First page is 1. No
pagesize Number of topics to return. Default is 100. No
keyword Keyword filter for Code, Title, or Description No
categories A comma delimited string of categories names or ids. For example: Windows,Architecture,Breakout No
speaker A comma delimited list of speaker id's No
timeslot A timeslot id No
day A day. e.g., 8/29/2011 No
start a time. e.g. 8/29/2011 8:00 AM or simply 8:00 AM. if no date is specified, then the default will be the current day if during the event OR the first day of the event. No
finish a time. e.g. 8/29/2011 8:00 AM or simply 8:00 AM. if no date is specified, then the default will be the current day if during the event OR the first day of the event. No
room room id No
includeinfo true/false. If false, a lesser amount of information is returned. If true, all topic information is returned. Use false to cut down on bandwidth usage. No
sort Sort topics by code,title,start,finish No
approvalstatus filter by approval status, by default only shows approved. 1=Proposed, 2=Approved, 3=Cancelled, 4=Declined. No
minpublishstatus filter by minimum publish status, by default only shows published. 0=Unpublished, 1=Title only, 6=Full. Default value is >= 1 No

Response data
{
    "total":470,
    "pagesize":1000,
    "page":1,
    "results":[
        {
            "id":"topic id",
            "code":"CODE01",
            "title":"Living the Lifestyle ",
            "description":"No technology has impacted programming in recent years the way code has.",
            "approvalstatus":"2",
            "publishingstatus":"6",
            "room":"",
            "start":"2012-02-15T00:00:00Z",
            "finish":"2012-02-15T00:00:00Z",
            "categoryids":[
                "category id 1",
                "category id 2",
                "category id 3"
                ],
            "speakerids":[
                "speaker id 1"
                ],
            "sessions":[
                    {
                        "id":"session id",
                        "roomId":"room id",
                        "timeslotId":"timeslot id",
                        "allowscheduling":false,
                        "capacity":0
                    }
                ],
            "related":[
                    {
                        "name":"Associated",
                        "values":["id 1", "id 2"],
                        "topics":[
                                    { "id":"id 1", "code":"code 1", "title": "title 1" }
                                ]
                    }
                ],
            "info":[
                    {
                        "name":"extended_property",
                        "value":"some value"
                    }
                ],
            "documents":[
                    {
                        "name":"docname.txt",
                        "url":"http://someurl",
                        "contentlength":"199",
                        "objectid":"id of parent object",
                        "documenttype":"published slide"
                    }
                ]
        }
    ]
}
    
Retrieve a single topic

http://api.eventpoint.com/n.n/program/topic/[id or code] e.g. http://api.eventpoint.com/n.n/program/topic/CODE101. Note, this is not case sensitive. Response data

{
    "id":"topic id",
    "code":"CODE01",
    "title":"Living the Lifestyle ",
    "description":"No technology has impacted programming in recent years the way code has.",
    "approvalstatus":"2",
    "publishingstatus":"6",
    "room":"",
    "start":"2012-02-15T00:00:00Z",
    "finish":"2012-02-15T00:00:00Z",
    "score":"0.0",
    "categoryids":[
        "category id 1",
        "category id 2",
        "category id 3"
        ],
    "speakerids":[
        "speaker id 1"
        ],
    "sessions":[
            {
                "id":"session id",
                "roomId":"room id",
                "timeslotId":"timeslot id",
                "allowscheduling":false,
                "capacity":0
            }
        ],
    "related":[
            {
                "name":"Associated",
                "values":["id 1", "id 2"]
            }
        ],
    "documents":[
            {
                "url":"document url",
                "name":"name.pptx",
                "contentlength":"100000"
            }
        ],
    "info":[
            {
                "name":"extended_property",
                "value":"some value"
            }
        ]
}
    

Save topic data

http://api.eventpoint.com/n.n/topic/save

Use this method to update a topic. You do not need to include all the information, only the information that you want to update. For the topic, you can only update code, title, and description. If you do not include speakers or categories, those will not be updated.

This method is a json post.

Request format

{
    "id":"You must supply the id here",
    "registrantkey":"You must supply the registrant key of the user updating",
    "topic":{
        "title":"session title",
        "code":"code",
        "description":"description"
    },
    "speakers":[
        {"speakertype":"Primary Speaker","registrants":["reg key 1", "reg key 2"]},
        {"speakertype":"Assistant Speaker","registrants":["reg key 3", "reg key 4"]}
    ],
    "info":[
        {"name":"Twitter","value":"twitterid"},
        {"name":"Facebook","value":"facebookid"},
        {"name":"LinkedIn","value":"linkedinid"}
    ],
    "categories":[
        {
            "parentid":"parent id", 
            "categoryids":["category1", "categoryid2"]
        },
        {
            "parentid":"parent id", 
            "categoryids":["category1", "categoryid2"]
        }
    ]
}
    

Response data
{
    "success":true,
    "status":0,
    "message":""
}    
    

Session Changes

http://api.eventpoint.com/n.n/program/sessionchanges

Name Description Required
date Filter for session changes after a particular date No
registrantKey Filter for session changes relevant for a particular registrant No

Response data
[
    {
        "changedate":"2012-02-15T00:00:00Z",
        "changetype":"Timeslot Change/Room Change/Cancellation/NewTopic",
        "summary":"",
        "originalvalue":"old value",
        "newvalue":"new value",
        "topic": {
    "id":"topic id",
    "code":"CODE01",
    "title":"Living the Lifestyle ",
    "description":"No technology has impacted programming in recent years the way code has.",
    "approvalstatus":"2",
    "publishingstatus":"6",
    "room":"",
    "start":"2012-02-15T00:00:00Z",
    "finish":"2012-02-15T00:00:00Z",
    "score":"0.0",
    "sessions":[
            {
                "id":"session id",
                "roomId":"room id",
                "timeslotId":"timeslot id",
                "allowscheduling":false,
                "capacity":0
            }
        ],
    "info":[
            {
                "name":"extended_property",
                "value":"some value"
            }
        ]
}





    }
]
    

Categories

http://api.eventpoint.com/n.n/program/categories

Name Description Required
parent Filter categories for a specific parent. May be an ID or the Parent category name. e.g., Track No

Response data
[
    {
        "id":"category id",
        "parentid":"parent category id",
        "name":"Some Name",
        "shortdesc":"SN",
        "description":"category descripton",
        "publish":true
    }
]
    
Retrieve page content

http://api.eventpoint.com/n.n/program/pagecontent/[id or code]

Response data
{
    "id":"content id",
    "name":"Some Name",
    "code":"code",
    "url":"url",
    "html":"html content"
}
    
Retrieve a single category

http://api.eventpoint.com/n.n/program/category/[id or shortdesc or name]

Response data
{
    "id":"category id",
    "parentid":"parent category id",
    "name":"Some Name",
    "shortdesc":"SN",
    "publish":true
}
    

Days

Note that the date formats are specified via the EventPoint Admin

http://api.eventpoint.com/n.n/program/days

[
    {
        "date":"2012-02-15T00:00:00Z",
        "longformatteddate":"Monday, November 8",
        "shortformatteddate":"11/8/2010",
        "datestring" : "11/8/2010",
        "dateindex":1
     }
]
    

Timeslots

http://api.eventpoint.com/n.n/program/timeslots

Name Description Required
day Filter timeslots for a specifc day. No

Response data
[
    {
        "id":"timeslot id",
        "start":"2012-02-15T00:00:00Z",
        "finish":"2012-02-15T00:00:00Z",
        "type":"session",
        "formattedtimeslot": "8:00 AM- 9:00 PM",
        "publish":true
    }
]    
    

Rooms

http://api.eventpoint.com/n.n/program/rooms

Response data
[
    {
        "id":"room id",
        "name":"Hall 2b",
        "capacity":300,
        "type":"session",
        "publish":true
    }
]
    

Agenda

http://api.eventpoint.com/n.n/program/agenda

Name Description Required
day Filter agenda for a specifc day. No

Response data
[
    {
        "id":"agenda id",
        "title":"agenda item title",
        "code":"code",
        "description":"description",
        "room":"room",
        "start":"2012-02-15T00:00:00Z",
        "finish":"2012-02-15T00:00:00Z",
        "formattedtimeslot": "8:00 AM- 9:00 PM",
        "free1:"",
        "free2:"",
        "free3:"",
        "free4:"",
        "info":[
                {
                    "name":"extended_property",
                    "value":"some value"
                }
            ]
    }
]    
    

Documents

http://api.eventpoint.com/n.n/program/documents

Name Description Required
page The page to return. First page is 1. No
pagesize Number of topics to return. Default is 1000. No
documentType filter for document type No
keyword Keyword filter for Name or Description No
categories A comma delimited string of categories names or ids. For example: Windows,Architecture,Breakout No
objectids A comma delimited string of Object ids (topic or company). No

{
    "total":21,
    "pagesize":10000,
    "page":1,
    "results":
        [
                    {
                        "name":"docname.txt",
                        "url":"http://someurl",
                        "contentlength":"199",
                        "objectid":"id of parent object",
                        "documenttype":"published slide"
                    }
        ]
}
    

Speakers

http://api.eventpoint.com/n.n/program/speakers

Name Description Required
page The page to return. First page is 1. No
pagesize Number of topics to return. Default is 1000. No
keyword Keyword filter for Name or Description No
categories A comma delimited string of categories names or ids. For example: Windows,Architecture,Breakout No
includetopics Default value is "true". Tells service to return topics with speakers. No
includeinfo Default value is "false". Tells service to return registrant info with speakers. No

{
    "total":21,
    "pagesize":10000,
    "page":1,
    "results":
        [
            {
                "id":"speaker id",
                "registrantkey":"key here",
                "name":"John Smith",
                "jobtitle":"Senior Analyst",
                "companyname":"EventPoint",
                "photo":null,
                "bio":"John Smith is a Senior Analyst at EventPoint.  He likes books, long walks on the beach, and deep conversations.",
                "categoryids":[
                    "category id 1",
                    "category id 2",
                    "category id 3"
                    ],
                "topicids":[
                    "topic id 1",
                    "topic id 2",
                    "topic id 3"
                    ],
                "info":[
                        {
                            "name":"extended_property",
                            "value":"some value"
                        }
                    ]
             }
        ]
}
    
Retrieve a single speaker

http://api.eventpoint.com/n.n/program/speaker/[id or name]

Some examples include:

  • http://api.eventpoint.com/n.n/program/speaker/12345 (by id)
  • http://api.eventpoint.com/n.n/program/speaker/John_Smith (first and last name use underscore (_) instead of space)
  • http://api.eventpoint.com/n.n/program/speaker/John+Smith (first and last name - use plus (+) instead of space)
  • http://api.eventpoint.com/n.n/program/speaker/John%20Smith (first and last name - space is url encoded)
  • Response data
    {
        "id":"speaker id",
        "registrantkey":"key here",
        "name":"John Smith",
        "jobtitle":"Senior Analyst",
        "companyname":"EventPoint",
        "photo":null,
        "bio":"John Smith is a Senior Analyst at EventPoint.  He likes books, long walks on the beach, and deep conversations.",
        "categoryids":[
            "category id 1",
            "category id 2",
            "category id 3"
            ],
        "topicids":[
            "topic id 1",
            "topic id 2",
            "topic id 3"
            ],
        "info":[
                {
                    "name":"extended_property",
                    "value":"some value"
                }
            ]
    }
        

    Surveys (Evaluations)

    Surveys are used for session evaluations. To determine which survey to use, match a topic categories against the survey category.

    For question types, 1 = multiple choice, 2 or 5 = signle choice, 3 = short text, 4 = long text

    http://api.eventpoint.com/n.n/program/surveys

    Name Description Required
    parent Filter categories for a specific parent. May be an ID or the Parent category name. e.g., Track No

    Response data
    [
        {
            "id":"survey id",
            "name":"Some Name",
            "categoryids":["category id"],
            "questions":[
                {
                    "id": "question id",
                    "num": 1,
                    "questiontype": "1",
                    "text": "question text",
                    "answers": [
                        "id: "answer id",
                        "num": 1,
                        "text": "answer text"                    
                    ]
                }
            ]
            
        }
    ]
        

    Companies

    http://api.eventpoint.com/n.n/program/companies

    Companies are wrapped in a result that specifies the company results, current page, the page size, and the total number of companies returned. This service will let you query companies based on a variety of parameters, as noted below.

    Name Description Required
    page The page to return. First page is 1. No
    pagesize Number of topics to return. Default is 1000. No
    keyword Keyword filter for Name or Description No
    categories A comma delimited string of categories names or ids. For example: Windows,Architecture,Breakout No

    Response data
    {
        "total":470,
        "pagesize":1000,
        "page":1,
        "results":[
            {
                "id":"company id",
                "name":"Company name",
                "description":"This company is great.  It is.",
                "location":"location",
                "booth":"booth",
                "logo":"logo",
                "url":"http://www.eventpoint.com/",
                "email":"email",
                "phone":"phone",
                "address1":"address1",
                "address2":"address2",
                "city":"city",
                "state":"state",
                "zip":"zip",
                "country":"country",
                "categoryids":[
                    "category id 1",
                    "category id 2",
                    "category id 3"
                    ],
                "info":[
                        {
                            "name":"extended_property",
                            "value":"some value"
                        }
                    ]
            }
        ]
    }
        
    Retrieve a single company

    http://api.eventpoint.com/n.n/program/company/[id or name] e.g. http://api.eventpoint.com/n.n/program/company/EventPoint. Note, this is not case sensitive. Response data

    {
        "id":"company id",
        "name":"Company name",
        "description":"This company is great.  It is.",
        "location":"location",
        "booth":"booth",
        "url":"http://www.eventpoint.com/",
        "email":"email",
        "phone":"phone",
        "address1":"address1",
        "address2":"address2",
        "city":"city",
        "state":"state",
        "zip":"zip",
        "country":"country",
        "categoryids":[
            "category id 1",
            "category id 2",
            "category id 3"
            ],
        "info":[
                {
                    "name":"extended_property",
                    "value":"some value"
                }
            ]
    }
        

    Config

    http://api.eventpoint.com/n.n/program/config/[config name or id]

    If you were retreiving the configuration for mobile, you would for example use the url program/config/mobile-configuration-sys. EventPoint will supply you with application specific configuration identifiers.

    Response data
    [
        {
            "name":"extended_property",
            "value":"some value"
        }
    ]    
        

    Session Attendance and Monitoring

    Note, you must have an administrative apikey to access session attendance data.

    Session Monitoring

    Scan records

    http://api.eventpoint.com/n.n/sessionmonitor/scanned

    Use at leaset one or more of the below. If you do not use any parameters, no results will be returned.

    Name Description Required
    topicid No
    timeslotid No
    roomid No

    Response data
    
    [
        {
            "reguser":"registrant-login",
            "submittedregid":"reg id sent by scanner",
            "scantime":"2014-07-28T20:13:24",
            "created":"2014-07-28T21:50:26.617",
            "topicid":"topicid",
            "title":"topic title",
            "code":"code",
            "sessionid":"session id",
            "timeslotid":"timeslot",
            "roomid":"91c87b96-1b8d-4ed8-bcd4-035cf3f3263d",
            "capacity":null,
            "registrantkey":"registrant key",
            "email":"registrant@email",
            "firstname":"firstname",
            "lastname":"lastname",
            "thirdpartyid":"eventpoints record of the regid",
            "roomid":"roomid",
            "room":"room name",
            "timeslotid":"timeslot id",
            "start":"7/28/2014 13:35:00",
            "finish":"7/28/2014 14:50:00",
            "startutc":"7/28/2014 13:35:00",
            "finishutc":"7/28/2014 14:50:00"
        }
    ]
        
    Scan records

    http://api.eventpoint.com/n.n/sessionmonitor/registrantscans

    Use at one or the other below. If you do not use any parameters, no results will be returned.

    Name Description Required
    registrantKey No
    regid registration provider id No

    Response data
    
    [
        {
            "reguser":"registrant-login",
            "submittedregid":"reg id sent by scanner",
            "scantime":"2014-07-28T20:13:24",
            "created":"2014-07-28T21:50:26.617",
            "topicid":"topicid",
            "title":"topic title",
            "code":"code",
            "sessionid":"session id",
            "timeslotid":"timeslot",
            "roomid":"91c87b96-1b8d-4ed8-bcd4-035cf3f3263d",
            "capacity":null,
            "registrantkey":"registrant key",
            "email":"registrant@email",
            "firstname":"firstname",
            "lastname":"lastname",
            "thirdpartyid":"eventpoints record of the regid",
            "roomid":"roomid",
            "room":"room name",
            "timeslotid":"timeslot id",
            "start":"7/28/2014 13:35:00",
            "finish":"7/28/2014 14:50:00",
            "startutc":"7/28/2014 13:35:00",
            "finishutc":"7/28/2014 14:50:00"
        }
    ]
        
    Add attendance data

    http://api.eventpoint.com/n.n/sessionmonitor/add

    To add an attendance record, submit the id of the registration vendor (regid), timeslotid, and the roomid.

    Name Description Required
    regid This is the id for the registration vendor Yes
    timeslotid Yes
    roomid Yes
    scantime time the data was collected No

    Response data
    {
        "success":true,
        "status":0,
        "message":""
    }    
        
    Add attendance data for a situation without a set room or time

    http://api.eventpoint.com/n.n/sessionmonitor/add

    To add an attendance record for a session without a time or set room, such as for a hands-on lab, use the following parameters.

    Name Description Required
    user Username or login Yes
    topiccode Code of the topic, session, or lab - HOL01, for example Yes
    allowmultiple If this is true, you can submit multiple records for teh same user. This would be used in a situation where you monitor lab usage. No
    scantime time the data was collected No

    Response data
    {
        "success":true,
        "status":0,
        "message":""
    }    
        
    Remove attendance data

    http://api.eventpoint.com/n.n/sessionmonitor/remove

    To remove an attendance record, submit the id of the registration vendor (regid), timeslotid, and the roomid.

    Name Description Required
    regid This is the id for the registration vendor Yes
    timeslotid Yes
    roomid Yes

    Response data
    {
        "success":true,
        "status":0,
        "message":""
    }    
        
    List all approved sessions, regardless of publishing status

    http://api.eventpoint.com/n.n/sessionmonitor/approvedsessions

    This service returns the same data as the program/topics service, but it supplies a minpubstatus of 0.

    Name Description Required
    page No
    pagesize No

    Response data
    {
        "total":470,
        "pagesize":1000,
        "page":1,
        "results":[
            {
                "id":"topic id",
                "code":"CODE01",
                "title":"Living the Lifestyle ",
                "description":"No technology has impacted programming in recent years the way code has.",
                "approvalstatus":"2",
                "publishingstatus":"6",
                "room":"",
                "start":"2012-02-15T00:00:00Z",
                "finish":"2012-02-15T00:00:00Z",
                "categoryids":[
                    "category id 1",
                    "category id 2",
                    "category id 3"
                    ],
                "speakerids":[
                    "speaker id 1"
                    ],
                "sessions":[
                        {
                            "id":"session id",
                            "roomId":"room id",
                            "timeslotId":"timeslot id",
                            "allowscheduling":false,
                            "capacity":0
                        }
                    ],
                "related":[
                        {
                            "name":"Associated",
                            "values":["id 1", "id 2"],
                            "topics":[
                                        { "id":"id 1", "code":"code 1", "title": "title 1" }
                                    ]
                        }
                    ],
                "info":[
                        {
                            "name":"extended_property",
                            "value":"some value"
                        }
                    ],
                "documents":[
                        {
                            "name":"docname.txt",
                            "url":"http://someurl",
                            "contentlength":"199",
                            "objectid":"id of parent object",
                            "documenttype":"published slide"
                        }
                    ]
            }
        ]
    }    
        

    Manipulating Schedule Data

    Note, you must have an administrative apikey to access Registrant data.

    Retrieve Registrant Schedule

    http://api.eventpoint.com/n.n/schedule/get

    Parameters

    Name Description Required
    registrantkey The key for the registrant whose schedule to retrieve Yes
    sessions Include sessions in results. Default value is "true" No
    meetings Include meetings in results. Default value is "false" No
    appointments Include appointments in results. Default value is "false" No
    minpublishstatus filter by minimum publish status, by default only shows published. 0=Unpublished, 1=Title only, 6=Full. Default value is >= 1 No

    Response data
    {
        "topics":[
            {
                "id":"topic id",
                "code":"CODE1",
                "title": "My Session Title",
                "description":"topic description",
                "approvalstatus":"2",
                "publishingstatus":"6",
                "room":"",
                "start":"2012-02-15T00:00:00Z",
                "finish":"2012-02-15T00:00:00Z",
                "categoryids":null,
                "speakerids":null,
                "sessions":[
                        {
                            "id":"session id",
                            "roomId":"room id",
                            "timeslotId":"timeslot id",
                            "allowscheduling":false,
                            "capacity":0
                        }
                 ]
             }
         ],
        "meetings":[
        {
            "id":" meeting id ",
            "name":" name ",
            "description":" meeting description ",
            "status":"active",
            "start":"2012-02-15T00:00:00Z",
            "finish":"2012-02-15T00:00:00Z",
            "location":" meeting location ",
            "formattedtimeslot":"6:00 AM - 6:00 PM",
            "organizer":
                {
                    "key":" reg key ",
                    "name":"Joe Orgo",
                    "username":"joeorgo@eventpoint.com",
                    "email":"joeorgo@eventpoint.com",
                    "bio":"",
                    "jobtitle":"Joe Organizer",
                    "companyname":"eventpoint",
                    "role":"",
                    "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/averagejoeOrganizer.png",
                    "qlkey":null,
                    "info":null
                },
                "participants":
                [
                    {
                        "registrant":
                            {
                                "key":" reg key ",
                                "name":"Joe Smith",
                                "username":"joesmith@eventpoint.com",
                                "email":"joesmith@eventpoint.com",
                                "bio":"",
                                "jobtitle":"Average Joe",
                                "companyname":"eventpoint",
                                "role":"",
                                "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/averagejoe.png",
                                "qlkey":null,
                                "info":null
                            },
                            "status":"accepted"
                    }
                ]
        }
    
    ]
    
    
    }  
        

    Add Session to Registrant Schedule

    http://api.eventpoint.com/n.n/schedule/add

    Parameters

    Name Description Required
    registrantkey The key for the registrant whose schedule to update Yes
    sessionid The sessionid to add. Alternatively, if a topic id is used a best match is performed. Yes

    Response data
    {
        "success":true,
        "status":0,
        "message":"sessionID [session id] added to schedule for RegistrantKey [registrant key]."
    }    
        

    Remove Registrant Schedule

    http://api.eventpoint.com/n.n/schedule/remove

    Parameters

    Name Description Required
    registrantkey The key for the registrant whose schedule to update Yes
    sessionid The sessionid to remove. Alternatively, if a topic id is used a best match is performed. Yes

    Response data
    {
        "success":true,
        "status":0,
        "message":"sessionID [session id] removed from schedule for RegistrantKey [registrant key]."
    }    
        

    Internet Calendar URL

    http://api.eventpoint.com/n.n/schedule/ics

    Parameters

    Name Description Required
    registrantkey The key for the registrant whose schedule to update Yes

    Response data
    {
        "id":"https://somecode.eventpoint.com/feeds/ics.ashx/somelonguserspecifickey?programid=programidvalue",
        "success":true,
        "status":0,
        "message":"Interent Calendar"
    }    
        

    Free/Busy

    http://api.eventpoint.com/n.n/schedule/freebusy

    This service will examine a registrant's schedule, speaking schedule, and appointments and meeting to determine their Free/Busy status. Provide start and finish as UTC time.

    Parameters

    Name Description Required
    registrantkey The key for the registrant whose schedule to update Yes
    start The start of time range Yes
    finish The finish time Yes

    Response data
    {
        "id":null,
        "success":true,
        "status":0,
        "message":"FREE"  // OR "BUSY"
    }    
        

    Free/Busy Range

    http://api.eventpoint.com/n.n/schedule/freebusyrange

    This service will examine a registrant's schedule, speaking schedule, and appointments and meeting to determine their Free/Busy status. Provide start and finish as UTC time. Agenda is included by default.

    Parameters

    Name Description Required
    registrantkey The key for the registrant whose schedule to update Yes
    start The start of time range Yes
    finish The finish time Yes
    includeAgenda Include agenda. By default, this is "True" No
    includeTentative Include invited meetings No

    Response data
    [
        {
            "status":"BUSY",
            "start":"2012-02-15T00:00:00Z",
            "finish":"2012-02-15T00:00:00Z",
            "startutc":"2012-02-15T00:00:00Z",
            "finishutc":"2012-02-15T00:00:00Z"
        }
    ]    
        

    Add Ad-Hoc appointment

    http://api.eventpoint.com/n.n/schedule/saveappointment

    Parameters

    Name Description Required
    registrantkey The key for the registrant whose schedule to update Yes
    name The key for the registrant whose schedule to update no
    description The key for the registrant whose schedule to update no
    Start start time of the appointment Yes
    Finish finish time of the appointment Yes
    appointmentid to update appointment, include the appointmentid No

    Response data
    {
        "id":appointmentid,
        "start":"2012-02-15T00:00:00Z",
        "finish":"2012-02-15T00:00:00Z",
        "formattedtimeslot":"2/15/2012 8:00 PM",
        "status":"status",
        "name":"name",
        "description":"description",
        "location":"location"
    }    
        

    Delete Ad-Hoc appointment

    http://api.eventpoint.com/n.n/schedule/deleteappointment

    Parameters

    Name Description Required
    appointmentid The appointmentid to delete Yes

    Response data
    {
        "id":appointmentid,
        "success":true,
        "status":0,
        "message":""
    }    
        

    Session Attendance

    http://api.eventpoint.com/n.n/schedule/scheduledforsession/[id or code] e.g. http://api.eventpoint.com/n.n/schedule/scheduledforsession/CODE101. Note, this is not case sensitive.

    Name Description Required
    page The page to return. First page is 1. No
    pagesize Number of topics to return. Default is 1000. No

    {
        "total":21,
        "pagesize":100,
        "page":1,
        "results":
            [
                        {
                            "name":"docname.txt",
                            "url":"http://someurl",
                            "contentlength":"199",
                            "objectid":"id of parent object",
                            "documenttype":"published slide"
                        }
            ]
    }
        

    Session Attendance for a Registrant

    http://api.eventpoint.com/n.n/schedule/attendance

    Name Description Required
    registrantKey Yes
    evaluated true/false. If nothing is supplied, then all sessions attended are returned. If "true", then only those sessions that the registrant has evaluated are returned. If "false", sessions needing an evaluation are returned. No

    [
            {
                "id":"topic id",
                "code":"CODE1",
                "title": "My Session Title",
                "description":"topic description",
                "approvalstatus":"2",
                "publishingstatus":"6",
                "room":"",
                "start":"2012-02-15T00:00:00Z",
                "finish":"2012-02-15T00:00:00Z",
                "categoryids":null,
                "speakerids":null,
                "sessions":[
                        {
                            "id":"session id",
                            "roomId":"room id",
                            "timeslotId":"timeslot id",
                            "allowscheduling":false,
                            "capacity":0
                        }
                 ]
             }
    ]
        

    Registrants

    Note, you must have an administrative apikey to access Registrant data.

    Authenticating Registrant for Username and Password

    http://api.eventpoint.com/n.n/registrant/authenticate

    Registrants may also have arbitrary additional "info" fields as in the below sample response.

    Parameters

    Name Description Required
    username Registrant username Yes
    password Registrant password. Yes

    Response data
    {
        "registrant":{
            "key":"registrant id here",
            "name":"Joe User",
            "username":"joe_user",
            "email":"joeuser@eventpoint.com",
            "bio":"",
            "jobtitle":"",
            "companyname":"",
            "role":"",
            "code":"",
            "shareschedule":"false",
            "sharecontacts":"false",
            "sharetripreport":"false",
            "directoryoptin":"false",
            "thirdpartyid":"",
            "thirdpartycode":"false",
            "registrationcompletedate":"2012-02-15T00:00:00Z",
            "photo":"http://myphoto.png",
            "location": {
                "address1": "address1",
                "address2": "address2",
                "city": "city",
                "state": "state",
                "country": "country"
            },
            "info":[
                {"name":"Twitter","value":"twitterid"},
                {"name":"Facebook","value":"facebookid"},
                {"name":"LinkedIn","value":"linkedinid"}
             ],
            "categoryids":[
                "category id 1",
                "category id 2",
                "category id 3"
             ] 
        },
        "isvalid":true,
        "message":""
    }
        

    Note on sending authenticated registrant requests

    If you have a client application and you do not want to include your API key for security reasons, you can supply the QLkey of an authenticated registrant to return that person's data.

    If you call the Authenticate methods, you will get a session specific "qlkey" in the response. You DO NOT need to supply an API key to make authentication calls. You can then use that QLKey in subsequent calls by substituting your APIKEY value with that of the QLKey.

    To "sign out", call the below Expire Session.

    Expire a registrant's session

    http://api.eventpoint.com/n.n/registrant/expiresession

    Parameters

    Name Description Required
    puid qlkey Yes

    Response data
    {
        "Id":"response id",
        "Status":0,
        "Success":true,
        "Message":"status message"
    }
        

    Authenticating Registrant for QL Key

    http://api.eventpoint.com/n.n/registrant/authenticateforqlkey

    use a registrant's qL key to re-authenticate. Note that the QLKey that you provide for this will subsequently expire, and you will be provided with a new QLKey.

    Parameters

    Name Description Required
    puid Registrant qlkey Yes

    Response data
    {
        "registrant":{
            "key":"registrant id here",
            "name":"Joe User",
            "username":"joe_user",
            "email":"joeuser@eventpoint.com",
            "bio":"",
            "jobtitle":"",
            "companyname":"",
            "role":"",
            "code":"",
            "shareschedule":"false",
            "sharecontacts":"false",
            "sharetripreport":"false",
            "directoryoptin":"false",
            "thirdpartyid":"",
            "thirdpartycode":"false",
            "registrationcompletedate":"2012-02-15T00:00:00Z",
            "photo":"http://myphoto.png",
            "info":[
                {"name":"Twitter","value":"twitterid"},
                {"name":"Facebook","value":"facebookid"},
                {"name":"LinkedIn","value":"linkedinid"}
             ],
            "categoryids":[
                "category id 1",
                "category id 2",
                "category id 3"
             ] 
        },
        "isvalid":true,
        "message":""
    }
        

    Authenticating Registrant for Puid

    http://api.eventpoint.com/n.n/registrant/authenticateforpuid

    Parameters

    Name Description Required
    puid Registrant puid Yes

    Response data
    {
        "registrant":{
            "key":"registrant id here",
            "name":"Joe User",
            "username":"joe_user",
            "email":"joeuser@eventpoint.com",
            "bio":"",
            "jobtitle":"",
            "companyname":"",
            "role":"",
            "code":"",
            "shareschedule":"false",
            "sharecontacts":"false",
            "sharetripreport":"false",
            "directoryoptin":"false",
            "thirdpartyid":"",
            "thirdpartycode":"false",
            "registrationcompletedate":"2012-02-15T00:00:00Z",
            "photo":"http://myphoto.png",
            "location": {
                "address1": "address1",
                "address2": "address2",
                "city": "city",
                "state": "state",
                "country": "country"
            },
            "info":[
                {"name":"Twitter","value":"twitterid"},
                {"name":"Facebook","value":"facebookid"},
                {"name":"LinkedIn","value":"linkedinid"}
             ],
            "categoryids":[
                "category id 1",
                "category id 2",
                "category id 3"
             ] 
        },
        "isvalid":true,
        "message":""
    }
        

    Find Registrant for Key

    http://api.eventpoint.com/n.n/registrant/findbykey

    Parameters

    Name Description Required
    registrantkey Registrant Key Yes

    Response data
    {
        "registrant":{
            "key":"registrant id here",
            "name":"Joe User",
            "username":"joe_user",
            "email":"joeuser@eventpoint.com",
            "bio":"",
            "jobtitle":"",
            "companyname":"",
            "role":"",
            "code":"",
            "shareschedule":"false",
            "sharecontacts":"false",
            "sharetripreport":"false",
            "directoryoptin":"false",
            "thirdpartyid":"",
            "thirdpartycode":"false",
            "registrationcompletedate":"2012-02-15T00:00:00Z",
            "photo":"http://myphoto.png",
            "location": {
                "address1": "address1",
                "address2": "address2",
                "city": "city",
                "state": "state",
                "country": "country"
            },
            "info":[
                {"name":"Twitter","value":"twitterid"},
                {"name":"Facebook","value":"facebookid"},
                {"name":"LinkedIn","value":"linkedinid"}
             ],
            "categoryids":[
                "category id 1",
                "category id 2",
                "category id 3"
             ] 
        },
        "isvalid":true,
        "message":""
    }
        

    Find Registrant by Email

    http://api.eventpoint.com/n.n/registrant/findbyemail

    Parameters

    Name Description Required
    Email Registrant email address Yes

    Response data
    {
        "registrant":{
            "key":"registrant id here",
            "name":"Joe User",
            "username":"joe_user",
            "email":"joeuser@eventpoint.com",
            "bio":"",
            "jobtitle":"",
            "companyname":"",
            "role":"",
            "code":"",
            "shareschedule":"false",
            "sharecontacts":"false",
            "sharetripreport":"false",
            "directoryoptin":"false",
            "thirdpartyid":"",
            "thirdpartycode":"false",
            "registrationcompletedate":"2012-02-15T00:00:00Z",
            "photo":"http://myphoto.png",
            "location": {
                "address1": "address1",
                "address2": "address2",
                "city": "city",
                "state": "state",
                "country": "country"
            },
            "info":[
                {"name":"Twitter","value":"twitterid"},
                {"name":"Facebook","value":"facebookid"},
                {"name":"LinkedIn","value":"linkedinid"}
             ],
            "categoryids":[
                "category id 1",
                "category id 2",
                "category id 3"
             ] 
        },
        "isvalid":true,
        "message":""
    }
        

    Find Registrant by ThirdPartyID

    http://api.eventpoint.com/n.n/registrant/thirdpartyid

    Use this method when there is another registration vendor. This lets you find registrants in the reg vendor's system..

    Parameters

    Name Description Required
    regid third party registrant system id Yes

    Response data
    {
        "registrant":{
            "key":"registrant id here",
            "name":"Joe User",
            "username":"joe_user",
            "email":"joeuser@eventpoint.com",
            "bio":"",
            "jobtitle":"",
            "companyname":"",
            "role":"",
            "code":"",
            "shareschedule":"false",
            "sharecontacts":"false",
            "sharetripreport":"false",
            "directoryoptin":"false",
            "thirdpartyid":"",
            "thirdpartycode":"false",
            "registrationcompletedate":"2012-02-15T00:00:00Z",
            "photo":"http://myphoto.png",
            "location": {
                "address1": "address1",
                "address2": "address2",
                "city": "city",
                "state": "state",
                "country": "country"
            },
            "info":[
                {"name":"Twitter","value":"twitterid"},
                {"name":"Facebook","value":"facebookid"},
                {"name":"LinkedIn","value":"linkedinid"}
             ],
            "categoryids":[
                "category id 1",
                "category id 2",
                "category id 3"
             ] 
        },
        "isvalid":true,
        "message":""
    }
        

    Find Registrant by Identity Provider

    http://api.eventpoint.com/n.n/registrant/findbyipid

    Use this method when there are identity providers used.

    Parameters

    Name Description Required
    provider Identity provider. For example, "microsoft" or "adfs" No
    ipid The id or the token to use to lookup a registrant associated with this provider Yes

    Response data
    {
        "registrant":{
            "key":"registrant id here",
            "name":"Joe User",
            "username":"joe_user",
            "email":"joeuser@eventpoint.com",
            "bio":"",
            "jobtitle":"",
            "companyname":"",
            "role":"",
            "code":"",
            "shareschedule":"false",
            "sharecontacts":"false",
            "sharetripreport":"false",
            "directoryoptin":"false",
            "thirdpartyid":"",
            "thirdpartycode":"false",
            "registrationcompletedate":"2012-02-15T00:00:00Z",
            "photo":"http://myphoto.png",
            "location": {
                "address1": "address1",
                "address2": "address2",
                "city": "city",
                "state": "state",
                "country": "country"
            },
            "info":[
                {"name":"Twitter","value":"twitterid"},
                {"name":"Facebook","value":"facebookid"},
                {"name":"LinkedIn","value":"linkedinid"}
             ],
            "categoryids":[
                "category id 1",
                "category id 2",
                "category id 3"
             ] 
        },
        "isvalid":true,
        "message":""
    }
        

    Check directory opt-in status for a registrant

    http://api.eventpoint.com/n.n/registrant/optedin

    Use this method to check a registrant directory optin status. If Status=1, the registrant is optedin. If Status=0, the registrant is not opted in.

    Parameters

    Name Description Required
    registrantKey the EventPoint registrant key Yes

    Response data
    {
        "Id":"registrantKey",
        "Status":1,
        "Success":true,
        "Message":"registrantKey is opted in"
    }
        

    Change directory opt-in status for a registrant

    http://api.eventpoint.com/n.n/registrant/directoryoptin

    Use this method to update a registrant directory optin status

    Parameters

    Name Description Required
    registrantKey the EventPoint registrant key Yes
    optin True or false. "True" to opt in to attendee directory. Yes

    Response data
    {
        "registrant":{
            "key":"registrant id here",
            "name":"Joe User",
            "username":"joe_user",
            "email":"joeuser@eventpoint.com",
            "bio":"",
            "jobtitle":"",
            "companyname":"",
            "role":"",
            "code":"",
            "shareschedule":"false",
            "sharecontacts":"false",
            "sharetripreport":"false",
            "directoryoptin":"false",
            "thirdpartyid":"",
            "thirdpartycode":"false",
            "registrationcompletedate":"2012-02-15T00:00:00Z",
            "photo":"http://myphoto.png",
            "location": {
                "address1": "address1",
                "address2": "address2",
                "city": "city",
                "state": "state",
                "country": "country"
            },
            "info":[
                {"name":"Twitter","value":"twitterid"},
                {"name":"Facebook","value":"facebookid"},
                {"name":"LinkedIn","value":"linkedinid"}
             ],
            "categoryids":[
                "category id 1",
                "category id 2",
                "category id 3"
             ] 
        },
        "isvalid":true,
        "message":""
    }
        

    Save registrant data

    http://api.eventpoint.com/n.n/registrant/save

    Use this method to update a registrant

    This method is a json post.

    Request format

    {
        "key":"You must supply the registrant key here",
        "registrant":{
            "name":"Joe User",
            "email":"joeuser@eventpoint.com",
            "bio":"",
            "jobtitle":"",
            "companyname":"",
            "shareschedule":"false",
            "sharecontacts":"false",
            "sharetripreport":"false",
            "directoryoptin":"false",
            "thirdpartyid":"",
            "thirdpartycode":"false",
            "registrationcompletedate":"2012-02-15T00:00:00Z",
            "photo":"http://myphoto.png"
        },
        "info":[
            {"name":"Twitter","value":"twitterid"},
            {"name":"Facebook","value":"facebookid"},
            {"name":"LinkedIn","value":"linkedinid"}
        ],
        "categories":[
            {
                "parentid":"parent id", 
                "categoryids":["category1", "categoryid2"]
            },
            {
                "parentid":"parent id", 
                "categoryids":["category1", "categoryid2"]
            }
        ]
    }
        

    Response data
    {
        "registrant":{
            "key":"registrant id here",
            "name":"Joe User",
            "username":"joe_user",
            "email":"joeuser@eventpoint.com",
            "bio":"",
            "jobtitle":"",
            "companyname":"",
            "role":"",
            "code":"",
            "shareschedule":"false",
            "sharecontacts":"false",
            "sharetripreport":"false",
            "directoryoptin":"false",
            "thirdpartyid":"",
            "thirdpartycode":"false",
            "registrationcompletedate":"2012-02-15T00:00:00Z",
            "photo":"http://myphoto.png",
            "location": {
                "address1": "address1",
                "address2": "address2",
                "city": "city",
                "state": "state",
                "country": "country"
            },
            "info":[
                {"name":"Twitter","value":"twitterid"},
                {"name":"Facebook","value":"facebookid"},
                {"name":"LinkedIn","value":"linkedinid"}
             ],
            "categoryids":[
                "category id 1",
                "category id 2",
                "category id 3"
             ] 
        },
        "isvalid":true,
        "message":""
    }
        

    Auth Methods

    These methods are used in conjunction with auth.eventpoint.com

    Create an auth token

    http://api.eventpoint.com/n.n/auth/create

    Note: you need to use one of the following: ipid, thirdPartyId, or registrantKey

    Parameters

    Name Description Required
    dest the destination for the auth request Yes
    provider the identity provider for the auth request. can be adfs, msaccount, etc. Yes
    responseType the format for the response No
    registrantKey the EventPoint registrant key No
    ipid The id for the identity provider No
    thirdPartyId Generally, the id for the reg provider No

    Response data
    {
        authtoken: "",
        registrantkey: "",
        ipid: "",
        dest: "",
        url: ""
    }
        

    Find an auth token

    http://api.eventpoint.com/n.n/auth/find

    Parameters

    Name Description Required
    authToken the authToken of the request you are looking for. Each token can only be used once. Yes

    Response data
    {
        authtoken: "",
        registrantkey: "",
        ipid: "id identity provider's unique identifier",
        ipemailaddress: "account email address if available",
        dest: "",
        url: ""
    }
        

    Exhibitors

    Note, you must have an administrative apikey to access certain Exhibitor data.

    AddRegistrantExpo

    http://api.eventpoint.com/n.n/expo/addregistrantexpo

    Parameters

    Name Description Required
    registrantKey Registrant Key. Yes
    companyid Company/Exhibitor id Yes

    Response data
    {
        "Id":"response id",
        "Status":0,
        "Success":true,
        "Message":"status message"
    }
        

    RemoveRegistrantExpo

    http://api.eventpoint.com/n.n/expo/removeregistrantexpo

    Parameters

    Name Description Required
    registrantKey Registrant Key. Yes
    companyid Company/Exhibitor id Yes

    Response data
    {
        "Id":"response id",
        "Status":0,
        "Success":true,
        "Message":"status message"
    }
        

    RegistrantsForExpo

    http://api.eventpoint.com/n.n/expo/registrantsforexpo

    Parameters

    Name Description Required
    companyid Company/Exhibitor id Yes

    Response data
    [
        {
            "key":" reg key ",
            "name":"Joe Smith",
            "username":"joesmith@eventpoint.com",
            "email":"joesmith@eventpoint.com",
            "bio":"",
            "jobtitle":"Average Joe",
            "companyname":"eventpoint",
            "role":"",
            "code":"",
            "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/averagejoe.png",
            "qlkey":null,
            "info":null
        }
    ]
        

    RegistrantsForExpo

    http://api.eventpoint.com/n.n/expo/exposforregistrant

    Parameters

    Name Description Required
    companyid Company/Exhibitor id Yes

    Response data
    [
        {
            "id":"company id",
            "name":"Company name",
            "description":"This company is great.  It is.",
            "location":"location",
            "booth":"booth",
            "url":"http://www.eventpoint.com/",
            "categoryids":[
                "category id 1",
                "category id 2",
                "category id 3"
                ],
            "info":[
                    {
                        "name":"extended_property",
                        "value":"some value"
                    }
                ]
        }
    ]
        

    Evaluations

    Note, you must have an administrative apikey to access certain Eval data.

    Submit Evaluation

    http://api.eventpoint.com/n.n/eval/submitsurvey

    Parameters

    Name Description Required
    objectid Id of session or topic or company. This is to submit an evaluation for that object. If no objectid is specified, the eval is submitted as an "overall evaluation". Yes
    registrantKey registrant key of registrant submitting survey Yes
    surveyId Survey id. No
    q1,q2,q3,etc Note, these are not "officially" parameter names. These are dependent on the particular survey being submitted. So, if you had a survey with question numbers 1, 2, and 3, where 1&2 are a single choice answer, and 3 is a text answer, you would submit the following parameters:
    q1=answerid_1
    &q2=answerid_2
    &q3=some free form text
    Yes

    Response data Response data
    {
        "id":"response id",
        "status":0,
        "success":true,
        "message":"status message"
    }
        

    Completed Evaluations

    http://api.eventpoint.com/n.n/eval/completedsurveys

    Use this service to retrieve a list of completed surveys and evaluations. NOTE, if this is a "Session Evaluation", the "objectid" will always be the SessionId, not the TopicId, regardless of whether or not the evaluation was submitted with a "SessionId"

    Parameters

    Name Description Required
    registrantKey Key of registrant who to retrieve completes surveys. Yes

    Response data
    { 
        "message":null,
        "surveys":[
            {"surveyid":"surveyid 1","objectid":"sessionid 2","completeddate":"2012-06-14T14:15:36"},
            {"surveyid":"surveyid 1","objectid":"sessionid 1","completeddate":"2012-06-14T14:16:10"}
        ]
    }
        

    Sessions to be Evaluated

    http://api.eventpoint.com/n.n/eval/sessionstoevaluate

    Use this service to retrieve a list of surveys and objectids that need to be evaluated. NOTE, These are for "Session Evaluations". The "objectid" will always be the SessionId, not the TopicId, regardless of whether or not the evaluation was submitted with a "SessionId"

    Parameters

    Name Description Required
    registrantKey Key of registrant who to retrieve completes surveys. Yes
    lookupType value of "schedule" or "attendance". Retrieves data based on lookup type. Default is "schedule" No

    Response data
    { 
        "message":null,
        "surveys":[
            {"surveyid":"surveyid 1","objectid":"sessionid 2","completeddate":"2012-06-14T14:15:36"},
            {"surveyid":"surveyid 1","objectid":"sessionid 1","completeddate":"2012-06-14T14:16:10"}
        ]
    }
        

    Can Submit Survey

    http://api.eventpoint.com/n.n/eval/cansubmitsurvey

    Use this service to check if a registrant can submit a survey

    Parameters

    Name Description Required
    objectid Id of session or topic or company. This is to submit an evaluation for that object. Yes
    registrantKey registrant key of registrant submitting survey Yes
    surveyId Survey id. No

    Response data
    {
        "id":"response id",
        "status":0,
        "success":true,
        "message":"status message"
    }
        

    Prize Winner Lookup

    http://api.eventpoint.com/n.n/eval/prizewinnerlookup

    Use this service to check a registrant has won a prize for submitting a survey. If a surveyid and objectid are specified, the lookup is done for that survey/object/registrant combination. Otherwise it is done for the registrant, which is useful for notifying a registrant he/she has won a prize.

    Parameters

    Name Description Required
    objectid Id of session or topic or company. This is to submit an evaluation for that object. No
    registrantKey registrant key of registrant submitting survey Yes
    surveyId Survey id. No

    Response data
    {
        "id":"response id",
        "status":0,
        "success":true,
        "message":"Message indicating you have on a prize, potentially HTML formatted."
    }
        

    Evaluation Respondents

    http://api.eventpoint.com/n.n/eval/respondents

    Use this service to retrieve a list of registrants who have completed an evaluation for a session

    Use either topicid or sessionid.

    Parameters

    Name Description Required
    topicid topicid of session. Yes
    sessionid Yes

    Messages

    Note, you must have an administrative apikey to access certain Message data.

    Threads

    http://api.eventpoint.com/n.n/message/inbox

    Parameters

    Name Description Required
    registrantKey registrantKey for inbox to return. Yes
    date date filter No
    page The page to return. First page is 1. No
    pagesize Number of topics to return. Default is 1000. No
    keyword Keyword filter for Subject or Description No

    Response data
    {
        "total":21,
        "pagesize":10000,
        "page":1,
        "results":
            [
                {
                     "id":" thread id ",
                    "subject":"Event Logistics",
                    "body":"Discuss the Event Logistics",
                    "threadid":"",
                    "parentid":"",
                    "messagetype":"message",
                    "level":1,
                    "isread":"false",
                    "isdeleted":"false",
                    "isarchived":"false",
                    "created":"2012-02-15T00:00:00Z",
                    "author":
                        {
                            "key":" reg key ",
                            "name":"Dude Lebowski",
                            "username":"dude@eventpoint.com",
                            "email":"dude@eventpoint.com",
                            "bio":"",
                            "jobtitle":"dude",
                            "companyname":"eventpiont",
                            "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/92acbbec-d427-e011-be0d-001ec953730b.png",
                            "qlkey":null,
                            "info":null
                        }
                }
            ]
    }
        

    Messages

    Note, you must have an administrative apikey to access certain Message data.

    Threads

    http://api.eventpoint.com/n.n/message/bytype

    Parameters

    Name Description Required
    messageType messageType to search. Yes
    registrantKey key for registrant so as to determine read/not read status of messages. No
    date date filter No
    page The page to return. First page is 1. No
    pagesize Number of topics to return. Default is 1000. No

    Response data
    {
        "total":21,
        "pagesize":10000,
        "page":1,
        "results":
            [
                {
                    "id":" thread id ",
                    "subject":"Event Logistics",
                    "body":"Discuss the Event Logistics",
                    "threadid":"",
                    "parentid":"",
                    "messagetype":"message",
                    "level":1,
                    "isread":"false",
                    "isdeleted":"false",
                    "isarchived":"false",
                    "created":"2012-02-15T00:00:00Z",
                    "author":
                        {
                            "key":" reg key ",
                            "name":"Dude Lebowski",
                            "username":"dude@eventpoint.com",
                            "email":"dude@eventpoint.com",
                            "bio":"",
                            "jobtitle":"dude",
                            "companyname":"eventpiont",
                            "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/92acbbec-d427-e011-be0d-001ec953730b.png",
                            "qlkey":null,
                            "info":null
                        }
                }
            ]
    }
        

    View Message

    http://api.eventpoint.com/n.n/message/view/[id]

    Parameters

    Name Description Required
    id Message id. Yes

    Response data
    {
        "id":" message id ",
        "subject":"Post from Averag Joe",
        "body":" body of post ",
        "threadid":" thread id ",
        "parentid":" parent id ( note it can be the thread id) ",
        "messagetype":"message",
        "created":"2012-02-15T00:00:00Z",
        "level":1,
        "author":
            {
                "key":" reg key ",
                "name":"Joe Smith",
                "username":"joesmith@eventpoint.com",
                "email":"joesmith@eventpoint.com",
                "bio":"",
                "jobtitle":"Average Joe",
                "companyname":"eventpoint",
                "role":"",
                "code":"",
                "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/averagejoe.png",
                "qlkey":null,
                "info":null
            } 
    }  
        

    Send

    http://api.eventpoint.com/n.n/message/send

    Parameters

    Name Description Required
    registrantKey registrant key. Yes
    messageToRegistrantKey Recipient registrant key. Yes
    subject Message subject Yes
    body Message body Yes
    parentid Id of parent message No

    Response data
    {
        "id":"message id",
        "success":true,
        "status":0,
        "message":"Message contents successfully removed"
    }
        

    Delete Message

    http://api.eventpoint.com/n.n/message/delete/[id]

    Parameters

    Name Description Required
    id Message id. Yes

    Response data
    {
        "id":"message id",
        "success":true,
        "status":0,
        "message":"Message contents successfully removed"
    }
        

    Mark Read

    http://api.eventpoint.com/n.n/message/markread

    Parameters

    Name Description Required
    registrantKey registrant key. Yes
    messageid Id of message. Yes

    Response data
    {
        "id":"message id",
        "success":true,
        "status":0,
        "message":"Message contents successfully removed"
    }
        

    Mark Unread

    http://api.eventpoint.com/n.n/message/markunread

    Parameters

    Name Description Required
    registrantKey registrant key. Yes
    messageid Id of message. Yes

    Response data
    {
        "id":"message id",
        "success":true,
        "status":0,
        "message":"Message contents successfully removed"
    }
        

    Discussions

    Note, you must have an administrative apikey to access certain Discussion data.

    Threads

    http://api.eventpoint.com/n.n/discussion/threads

    Parameters

    Name Description Required
    objectid Id of session or company. This is to retrieve discussions for that object. No
    objecttype Value of 'session' or 'company'. To retrieve a list of all company discussions, use objecttype=company No
    page The page to return. First page is 1. No
    pagesize Number of topics to return. Default is 1000. No
    keyword Keyword filter for Subject or Description No

    Response data
    {
        "total":21,
        "pagesize":10000,
        "page":1,
        "results":
            [
                {
                    "id":" thread id ",
                    "subject":"Event Logistics",
                    "body":"Discuss the Event Logistics",
                    "objectid":"",
                    "objecttype":"",
                    "numposts":55,
                    "isarchived":"false",
                    "lastmessageid":" message id ",
                    "lastpostdate":"2012-02-15T00:00:00Z",
                    "created":"2012-02-15T00:00:00Z",
                    "lastauthor":
                        {
                            "key":" reg key ",
                            "name":"Dude Lebowski",
                            "username":"dude@eventpoint.com",
                            "email":"dude@eventpoint.com",
                            "bio":"",
                            "jobtitle":"dude",
                            "companyname":"eventpiont",
                            "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/92acbbec-d427-e011-be0d-001ec953730b.png",
                            "qlkey":null,
                            "info":null
                        },
                    "author":
                        {
                            "key":" reg key ",
                            "name":"Dude Lebowski",
                            "username":"dude@eventpoint.com",
                            "email":"dude@eventpoint.com",
                            "bio":"",
                            "jobtitle":"dude",
                            "companyname":"eventpiont",
                            "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/92acbbec-d427-e011-be0d-001ec953730b.png",
                            "qlkey":null,
                            "info":null
                        },
                     "replies":null
                }
            ]
    }
        

    Retrieve a Thread

    http://api.eventpoint.com/n.n/discussion/thread/[id]

    NOTE: You must either supply the id, or objectid=[session or companyid]. Also note, that messages are sorted according to their most recent activity in decending order, but threading is also kept in tact. The messages will be order by level, and then by created date. For instance, here is a typical ordering:

    M 1
      R 1.1
         R 1.1.1
         R 1.1.2
    M 2
      R 2.1
         R 2.1.1
      R 2.2
         R 2.2.1
                
    Also note, that message replies are not embedded as documents recursively within each other. Use the level property to determine how to render your message. Finally, if you supply the "view" parameter, message threading will not be taken into account.

    Parameters

    Name Description Required
    id Thread Id No
    objectid Instead of using threadid, you may pass objectid. This will retrieve a session or company discussion. No
    page The page to return. First page is 1. No
    pagesize Number of topics to return. Default is 1000. No
    keyword Keyword filter for Subject or Description No
    sort Possible values of "created" or "numposts". "created" is the default order, and it sorts messages in decending order. No
    view If you supply a value of 'list', then a non-threaded list is supplied No

    Response data
    {
        "total":21,
        "pagesize":10000,
        "page":1,
        "results":
            [
                {
                    "id":" thread id ",
                    "subject":"Event Logistics",
                    "body":"Discuss the Event Logistics",
                    "objectid":"",
                    "objecttype":"",
                    "numposts":55,
                    "isarchived":"false",
                    "lastmessageid":" message id ",
                    "lastpostdate":"2012-02-15T00:00:00Z",
                    "created":"2012-02-15T00:00:00Z",
                    "lastauthor":
                        {
                            "key":" reg key ",
                            "name":"Dude Lebowski",
                            "username":"dude@eventpoint.com",
                            "email":"dude@eventpoint.com",
                            "bio":"",
                            "jobtitle":"dude",
                            "companyname":"eventpiont",
                            "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/92acbbec-d427-e011-be0d-001ec953730b.png",
                            "qlkey":null,
                            "info":null
                        },
                    "author":
                        {
                            "key":" reg key ",
                            "name":"Dude Lebowski",
                            "username":"dude@eventpoint.com",
                            "email":"dude@eventpoint.com",
                            "bio":"",
                            "jobtitle":"dude",
                            "companyname":"eventpoint",
                            "role":"",
                            "code":"",
                            "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/thedude.png",
                            "qlkey":null,
                            "info":null
                        },
                     "replies":
                        [
                            {
                                "id":" message id ",
                                "subject":"Post from Averag Joe",
                                "body":" body of post ",
                                "threadid":" thread id ",
                                "parentid":" parent id ( note it can be the thread id) ",
                                "messagetype":"message",
                                "created":"2012-02-15T00:00:00Z",
                                "level":1,
                                "author":
                                    {
                                        "key":" reg key ",
                                        "name":"Joe Smith",
                                        "username":"joesmith@eventpoint.com",
                                        "email":"joesmith@eventpoint.com",
                                        "bio":"",
                                        "jobtitle":"Average Joe",
                                        "companyname":"eventpoint",
                                        "role":"",
                                        "code":"",
                                        "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/averagejoe.png",
                                        "qlkey":null,
                                        "info":null
                                    } 
                            }                                   
                        ]
                }
            ]
    }
        

    View Message

    http://api.eventpoint.com/n.n/discussion/message/[id]

    Parameters

    Name Description Required
    id Message id. Yes

    Response data
    {
        "id":" message id ",
        "subject":"Post from Averag Joe",
        "body":" body of post ",
        "threadid":" thread id ",
        "parentid":" parent id ( note it can be the thread id) ",
        "messagetype":"message",
        "created":"2012-02-15T00:00:00Z",
        "level":1,
        "author":
            {
                "key":" reg key ",
                "name":"Joe Smith",
                "username":"joesmith@eventpoint.com",
                "email":"joesmith@eventpoint.com",
                "bio":"",
                "jobtitle":"Average Joe",
                "companyname":"eventpoint",
                "role":"",
                "code":"",
                "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/averagejoe.png",
                "qlkey":null,
                "info":null
            } 
    }  
        

    Add or Update a Message

    http://api.eventpoint.com/n.n/discussion/savemessage

    Parameters

    Name Description Required
    messageid if no messageid is supplied, a new message will be created. If a messageid is supplied, that message will be updated. No
    threadid thread id. Yes
    parentid if this message is a reply to another message, then supply that message's id for the parentid. No
    objectid the objectid to associate thread with. Currently only available for UserGroups. no
    objecttype The object type to associate thread with no
    subject Subject of Message No
    body Message body. No
    registrantKey Key of registrant who message is from. Yes

    Response data
    {
        "id":"message id",
        "success":true,
        "status":0,
        "message":"Message has been posted ( id: message id )"
    }
        

    Delete Message

    http://api.eventpoint.com/n.n/discussion/deletemessage/[id]

    NOTE: in order to preserve the structure of a thread and all the replies, a message isn't actually deleted. Instead the Subject & Body are changed to 'Message Removed'. The original contents of the message remain tracked.

    Parameters

    Name Description Required
    id Message id. Yes

    Response data
    {
        "id":"message id",
        "success":true,
        "status":0,
        "message":"Message contents successfully removed"
    }
        

    Follow Message

    http://api.eventpoint.com/n.n/discussion/followmessage/

    Parameters

    Name Description Required
    messageidid Message id. Yes
    registrantKey Key of registrant Yes

    Response data
    {
        "id":"message id",
        "success":true,
        "status":0,
        "message":"Message followed for registrant "
    }
        

    Un-Follow Message

    http://api.eventpoint.com/n.n/discussion/unfollowmessage/

    Parameters

    Name Description Required
    messageidid Message id. Yes
    registrantKey Key of registrant Yes

    Response data
    {
        "id":"message id",
        "success":true,
        "status":0,
        "message":"Message unfollowed for registrant "
    }
        

    Messages followed by a registrant

    http://api.eventpoint.com/n.n/discussion/messagesfollowed/

    Parameters

    Name Description Required
    registrantKey Key of registrant Yes

    Response data
    [
        {
            "id":" message id ",
            "subject":"Post from Averag Joe",
            "body":" body of post ",
            "threadid":" thread id ",
            "parentid":" parent id ( note it can be the thread id) ",
            "created":"2012-02-15T00:00:00Z",
            "messagetype":"message",
            "level":1,
            "author":
                {
                    "key":" reg key ",
                    "name":"Joe Smith",
                    "username":"joesmith@eventpoint.com",
                    "email":"joesmith@eventpoint.com",
                    "bio":"",
                    "jobtitle":"Average Joe",
                    "companyname":"eventpoint",
                    "role":"",
                    "code":"",
                    "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/averagejoe.png",
                    "qlkey":null,
                    "info":null
                } 
        }  
    ]
        

    Messages posted by a registrant

    http://api.eventpoint.com/n.n/discussion/messagesbyperson/

    Parameters

    Name Description Required
    registrantKey Key of registrant Yes

    Response data
    [
        {
            "id":" message id ",
            "subject":"Post from Averag Joe",
            "body":" body of post ",
            "threadid":" thread id ",
            "parentid":" parent id ( note it can be the thread id) ",
            "created":"2012-02-15T00:00:00Z",
            "level":1,
            "author":
                {
                    "key":" reg key ",
                    "name":"Joe Smith",
                    "username":"joesmith@eventpoint.com",
                    "email":"joesmith@eventpoint.com",
                    "bio":"",
                    "jobtitle":"Average Joe",
                    "companyname":"eventpoint",
                    "role":"",
                    "code":"",
                    "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/averagejoe.png",
                    "qlkey":null,
                    "info":null
                } 
        }  
    ]
        

    Latest messages for a thread

    http://api.eventpoint.com/n.n/discussion/latestforthread/

    Parameters

    Name Description Required
    threadid Thread id Yes
    date Show only messages posted after a certain date No
    page The page to return. First page is 1. No
    pagesize Number of topics to return. Default is 1000. No

    Response data
    [
        {
            "id":" message id ",
            "subject":"Post from Averag Joe",
            "body":" body of post ",
            "threadid":" thread id ",
            "parentid":" parent id ( note it can be the thread id) ",
            "created":"2012-02-15T00:00:00Z",
            "messagetype":"message",
            "level":1,
            "author":
                {
                    "key":" reg key ",
                    "name":"Joe Smith",
                    "username":"joesmith@eventpoint.com",
                    "email":"joesmith@eventpoint.com",
                    "bio":"",
                    "jobtitle":"Average Joe",
                    "companyname":"eventpoint",
                    "role":"",
                    "code":"",
                    "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/averagejoe.png",
                    "qlkey":null,
                    "info":null
                } 
        }  
    ]
        

    People

    http://api.eventpoint.com/n.n/directory/people

    Registrants are wrapped in a result that specifies the results, current page, the page size, and the total number of registrants returned. This service will let you query registrants based on a variety of parameters, as noted below. Also, note that in order to be returned in the results that the registrant must be opted in to the Attendee Directory

    Name Description Required
    page The page to return. First page is 1. No
    pagesize Number of topics to return. Default is 100. No
    keyword Keyword filter for Code,Title, or Description No
    categories A comma delimited string of categories names or ids. For example: Windows,Architecture,Breakout No
    sort Sort results by firstname, lastname No

    Response data
    {
        "total":470,
        "pagesize":1000,
        "page":1,
        "results":
            [
                {
                    "key":" reg key ",
                    "name":"Joe Smith",
                    "username":"joesmith@eventpoint.com",
                    "email":"joesmith@eventpoint.com",
                    "bio":"",
                    "jobtitle":"Average Joe",
                    "companyname":"eventpoint",
                    "role":"",
                    "code":"",
                    "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/averagejoe.png",
                    "qlkey":null,
                    "info":null,
                    "categoryids":[
                        "category id 1",
                        "category id 2",
                        "category id 3"
                        ]
                }
            ]
    }
        
    Retrieve a single person

    http://api.eventpoint.com/n.n/directory/person/[registrantkey or name]

    Some examples include:

  • http://api.eventpoint.com/n.n/directory/person/12345 (by id)
  • http://api.eventpoint.com/n.n/directory/person/John_Smith (first and last name use underscore (_) instead of space)
  • http://api.eventpoint.com/n.n/directory/person/John+Smith (first and last name - use plus (+) instead of space)
  • http://api.eventpoint.com/n.n/directory/person/John%20Smith (first and last name - space is url encoded)
  • Response data
    {
        "registrant":{
            "key":"registrant id here",
            "name":"Joe User",
            "username":"joe_user",
            "email":"joeuser@eventpoint.com",
            "bio":"",
            "jobtitle":"",
            "companyname":"",
            "role":"",
            "code":"",
            "photo":"http://myphoto.png",
            "info":[
                {"name":"Twitter","value":"twitterid"},
                {"name":"Facebook","value":"facebookid"},
                {"name":"LinkedIn","value":"linkedinid"}
             ] ,
            "categoryids":[
                "category id 1",
                "category id 2",
                "category id 3"
                ]
        },
        "isvalid":true,
        "message":""
    }
        

    Contacts

    http://api.eventpoint.com/n.n/directory/contacts

    Name Description Required
    registrantKey Key of registrant Yes

    Response data
    {
        "total":470,
        "pagesize":1000,
        "page":1,
        "results":
            [
                {
                    "key":" reg key ",
                    "name":"Joe Smith",
                    "username":"joesmith@eventpoint.com",
                    "email":"joesmith@eventpoint.com",
                    "bio":"",
                    "jobtitle":"Average Joe",
                    "companyname":"eventpoint",
                    "role":"",
                    "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/averagejoe.png",
                    "qlkey":null,
                    "info":null,
                    "categoryids":[
                        "category id 1",
                        "category id 2",
                        "category id 3"
                        ]
    
                }
            ]
    }
        
    Add Contact

    http://api.eventpoint.com/n.n/directory/addcontact/

    Parameters

    Name Description Required
    registrantKey Key of registrant Yes
    addkey registrant to add as contact. Yes

    Response data
    {
        "id":"add key",
        "success":true,
        "status":0,
        "message":"Registrant added to contacts"
    }
        
    Remove Contact

    http://api.eventpoint.com/n.n/directory/removecontact/

    Parameters

    Name Description Required
    registrantKey Key of registrant Yes
    removekey registrant to remove as contact. Yes

    Response data
    {
        "id":"remove key",
        "success":true,
        "status":0,
        "message":"Registrant removed from contacts"
    }
        

    Similar People

    An algorithm is used to deterimine similar contacts

    http://api.eventpoint.com/n.n/directory/similar

    Name Description Required
    registrantKey Key of registrant Yes
    page The page to return. First page is 1. No
    pagesize Number of topics to return. Default is 100. No

    Response data
    {
        "total":470,
        "pagesize":1000,
        "page":1,
        "results":
            [
                {
                    "key":" reg key ",
                    "name":"Joe Smith",
                    "username":"joesmith@eventpoint.com",
                    "email":"joesmith@eventpoint.com",
                    "bio":"",
                    "jobtitle":"Average Joe",
                    "companyname":"eventpoint",
                    "role":"",
                    "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/averagejoe.png",
                    "qlkey":null,
                    "info":null,
                    "categoryids":[
                        "category id 1",
                        "category id 2",
                        "category id 3"
                        ]
                }
            ]
    }
        

    Send Message to another Registrant

    http://api.eventpoint.com/n.n/directory/sendmessage

    Name Description Required
    messageFromKey Key of registrant Yes
    messageToKey Key of registrant Yes
    subject subject of message. Yes
    body body of message. Yes
    parentid if this is a response, the parentid of the original message. No

    Response data
    {
        "id":"",
        "success":true,
        "status":0,
        "message":"message sent"
    }
        

    Meetings

    All of a registrant's meetings, including declined meetings

    http://api.eventpoint.com/n.n/directory/meetings

    Name Description Required
    registrantKey Key of registrant Yes

    Response data
    [
        {
            "id":" meeting id ",
            "name":" name ",
            "description":" meeting description ",
            "status":"active",
            "start":"2012-02-15T00:00:00Z",
            "finish":"2012-02-15T00:00:00Z",
            "location":" meeting location ",
            "locationdescription":"10 person table",
            "formattedtimeslot":"6:00 AM - 6:00 PM",
            "organizer":
                {
                    "key":" reg key ",
                    "name":"Joe Orgo",
                    "username":"joeorgo@eventpoint.com",
                    "email":"joeorgo@eventpoint.com",
                    "bio":"",
                    "jobtitle":"Joe Organizer",
                    "companyname":"eventpoint",
                    "role":"",
                    "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/averagejoeOrganizer.png",
                    "qlkey":null,
                    "info":null
                },
                "participants":
                [
                    {
                        "registrant":
                            {
                                "key":" reg key ",
                                "name":"Joe Smith",
                                "username":"joesmith@eventpoint.com",
                                "email":"joesmith@eventpoint.com",
                                "bio":"",
                                "jobtitle":"Average Joe",
                                "companyname":"eventpoint",
                                "role":"",
                                "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/averagejoe.png",
                                "qlkey":null,
                                "info":null
                            },
                            "status":"accepted"
                    }
                ]
        }
    
    ]
    
        
    View single meeting

    http://api.eventpoint.com/n.n/directory/meeting/[id]

    Parameters

    Name Description Required
    id meeting id Yes

    Response data
    {
        "id":" meeting id ",
        "name":" name ",
        "description":" meeting description ",
        "status":"active",
        "start":"2012-02-15T00:00:00Z",
        "finish":"2012-02-15T00:00:00Z",
        "location":" meeting location ",
        "locationdescription":"10 person table",
        "formattedtimeslot":"6:00 AM - 6:00 PM",
        "organizer":
            {
                "key":" reg key ",
                "name":"Joe Orgo",
                "username":"joeorgo@eventpoint.com",
                "email":"joeorgo@eventpoint.com",
                "bio":"",
                "jobtitle":"Joe Organizer",
                "companyname":"eventpoint",
                "role":"",
                "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/averagejoeOrganizer.png",
                "qlkey":null,
                "info":null
            },
         "participants":
            [
                {
                    "registrant":
                        {
                            "key":" reg key ",
                            "name":"Joe Smith",
                            "username":"joesmith@eventpoint.com",
                            "email":"joesmith@eventpoint.com",
                            "bio":"",
                            "jobtitle":"Average Joe",
                            "companyname":"eventpoint",
                            "role":"",
                            "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/averagejoe.png",
                            "qlkey":null,
                            "info":null
                        },
                     "status":"accepted"
                }
            ]
    }
            
    
        
    Add or update a meeting

    http://api.eventpoint.com/n.n/directory/savemeeting/

    NOTE: if this is a new meeting, do not supply a meetingid. You can get the value of the meetingid in the response.

    Parameters

    Name Description Required
    meetingid Meeting id No
    organizerKey Key of meeting organizer Yes
    name Meeting name Yes
    description Meeting description No
    start Meeting start time Yes
    finish Meeting finish time Yes
    location Meeting location. Do not send a meeting location if you send a tablesize and/or area No
    tablesize If automatic location scheduling is enabled, then send a table size No
    area If automatic location scheduling is enabled, then send optionally send an area No

    Response data
    {
        "id":"meeting id",
        "success":true,
        "status":0,
        "message":"Meeting has been saved"
    }  
    
        
    Check availablitly for structured meeting times.

    http://api.eventpoint.com/n.n/directory/checkmeetingavailability/

    If structured meetings are enabled, then you may want to check the availability for a time. NOTE: if this is a new meeting, do not supply a meetingid.

    Parameters

    Name Description Required
    meetingid Meeting id No
    start Meeting start time Yes
    finish Meeting finish time Yes
    location Meeting location. Do not send a meeting location if you send a tablesize and/or area No
    tablesize If automatic location scheduling is enabled, then send a table size No
    area If automatic location scheduling is enabled, then send optionally send an area No

    Response data
    {
        "id":"",
        "name":"",
        "canschedule":true,
        "status":0,
        "message":"Meeting time is available",
        "location":"",
        "start":"",
        "finish":"",
        "locationavailable":true,
        "timeavailable":true
    }  
        
    Check availablitly for structured meeting times - supply a start and finish, and get a list of table capacities and availability.

    http://api.eventpoint.com/n.n/directory/meetingavailabilityforrange/

    If structured meetings are enabled, then you may want to check the availability for a time. NOTE: if this is a new meeting, do not supply a meetingid.

    Parameters

    Name Description Required
    start Meeting start time Yes
    finish Meeting finish time Yes
    tablesize If automatic location scheduling is enabled, then send a table size No
    area If automatic location scheduling is enabled, then send optionally send an area No
    interval Number of minutes to use as an interval when creating the range. Default is 30. No

    Response data
    [{
    	"area": "",
    	"size": "4 Person Table",
    	"interval": 30,
    	"capacities": [{
    		"total": 88,
    		"scheduled": 83,
    		"start": "2015-07-13T13:00:00Z",
    		"finish": "2015-07-13T13:30:00Z",
    		"startutc": "2015-07-13T17:30:00Z",
    		"finishutc": "2015-07-13T17:30:00Z"
    	},
    	{
    		"total": 88,
    		"scheduled": 88,
    		"start": "2015-07-13T13:30:00Z",
    		"finish": "2015-07-13T14:00:00Z",
    		"startutc": "2015-07-13T18:00:00Z",
    		"finishutc": "2015-07-13T18:00:00Z"
    	},
    	{
    		"total": 88,
    		"scheduled": 5,
    		"start": "2015-07-13T14:00:00Z",
    		"finish": "2015-07-13T14:30:00Z",
    		"startutc": "2015-07-13T18:30:00Z",
    		"finishutc": "2015-07-13T18:30:00Z"
    	}]
    }] 
        
    Update meeting invitees

    http://api.eventpoint.com/n.n/directory/updatemeetinginvitees/

    Parameters

    Name Description Required
    meetingid meeting id Yes
    addinvitees comma delimited list of reg keys to add Yes
    removeinvitees comma delimited list of reg keys to remove Yes

    NOTE: The response to this service is the actual meeting itself, with all of the current participants

    Response data
    {
        "id":" meeting id ",
        "name":" name ",
        "description":" meeting description ",
        "status":"active",
        "start":"2012-02-15T00:00:00Z",
        "finish":"2012-02-15T00:00:00Z",
        "location":" meeting location ",
        "formattedtimeslot":"6:00 AM - 6:00 PM",
        "organizer":
            {
                "key":" reg key ",
                "name":"Joe Orgo",
                "username":"joeorgo@eventpoint.com",
                "email":"joeorgo@eventpoint.com",
                "bio":"",
                "jobtitle":"Joe Organizer",
                "companyname":"eventpoint",
                "role":"",
                "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/averagejoeOrganizer.png",
                "qlkey":null,
                "info":null
            },
         "participants":
            [
                {
                    "registrant":
                        {
                            "key":" reg key ",
                            "name":"Joe Smith",
                            "username":"joesmith@eventpoint.com",
                            "email":"joesmith@eventpoint.com",
                            "bio":"",
                            "jobtitle":"Average Joe",
                            "companyname":"eventpoint",
                            "role":"",
                            "photo":"https://someevent.eventpoint.com/resources/documents/p/someevent/photos/averagejoe.png",
                            "qlkey":null,
                            "info":null
                        },
                     "status":"accepted"
                }
            ]
    }
            
    
        
    Cancel a meeting

    http://api.eventpoint.com/n.n/directory/cancelmeeting/

    This lets the organizer of the meeting cancel the actual meeting

    Parameters

    Name Description Required
    meetingid Meeting id Yes

    Response data
    {
        "id":"meeting id",
        "success":true,
        "status":0,
        "message":"Meeting has been cancelled"
    }  
    
        
    Accept a meeting invitation

    http://api.eventpoint.com/n.n/directory/acceptmeeting/

    Parameters

    Name Description Required
    meetingid Meeting id Yes
    registrantKey key of registrant to accept meeting Yes

    Response data
    {
        "id":"meeting id",
        "success":true,
        "status":0,
        "message":"Meeting invitation has been accepted"
    }  
    
        
    Decline a meeting invitation

    http://api.eventpoint.com/n.n/directory/declinemeeting/

    Parameters

    Name Description Required
    meetingid Meeting id Yes
    registrantKey key of registrant to accept meeting Yes

    Response data
    {
        "id":"meeting id",
        "success":true,
        "status":0,
        "message":"Meeting Inviation has been declined"
    }  
    
        

    Send Message meeting participants

    http://api.eventpoint.com/n.n/directory/sendmeetingmessage

    Name Description Required
    meetingid Meeting id Yes
    registrantKey Key of registrant to send from Yes
    body body of message. Yes

    Response data
    {
        "id":"",
        "success":true,
        "status":0,
        "message":"message sent"
    }