GET api/v2.0/Volunteer/GetUpcomingVolunteerOpportunities?opportunityTypeKey={opportunityTypeKey}&communityKey={communityKey}&maxToRetrieve={maxToRetrieve}
Returns Upcoming VolunteerOpportunies for Current User.
Request Information
URI Parameters
Name | Description | Type | Additional information |
---|---|---|---|
opportunityTypeKey |
Optional parameter. When included, limits returned Posts to this Opportunity Type. |
globally unique identifier |
None. |
communityKey |
Optional parameter. When included, limits returned Posts to this Community if Associated with the Opportunity. |
globally unique identifier |
None. |
maxToRetrieve |
Maximum records to retrieve. |
integer |
Default value is 20 |
Body Parameters
None.
Response Information
Resource Description
Collection of VolunteerOpportunityName | Description | Type | Additional information |
---|---|---|---|
VolunteerOpportunityKey |
The Unique Identifier for the Volunteer Opportunity. |
globally unique identifier |
None. |
Title |
The Title of the Volunteer Opportunity. |
string |
None. |
Description |
Descriptions for the Volunteer Opportunity. |
string |
None. |
Deadline |
Sign-up deadline for the Volunteer Opportunity. |
string |
None. |
AdditionalRequirements |
Additional Volunteer Requirements for this Volunteer Opportunity. |
string |
None. |
Location |
Location for the Volunteer Opportunity. |
string |
None. |
VolunteersNeeded |
Number of Volunteers needed for this Volunteer Opportunity. |
integer |
None. |
CreatedOn |
Date the Volunteer Opportunity was created. |
date |
None. |
CloseDate |
Date that registration as a Volunteer Closes. |
date |
None. |
UpdatedOn |
Date this Volunteer Opportunity was last updated. |
date |
None. |
EstimatedHours |
Estimated Hours required for the Volunteer Opportunity. |
decimal number |
None. |
SkillMultiplier | decimal number |
None. |
|
StartDateTime |
Date and Time the Volunteer Opportunity begins. |
date |
None. |
EndDateTime |
Date and Time the Volunteer Opportunity ends. |
date |
None. |
Community |
If the Volunteer Opportunity is linked to a specific Community, this will contain the Community data for that Community. |
Community |
None. |
RequiresApproval |
Indicates whether the Volunteer Opportunity requires approval by an administrator. **Note that at this time, only Volunteer Opportunities where this value is FALSE can be Volunteered for via the API. |
boolean |
None. |
Status |
Enumeration for the Volunteer Opportunity's Status. May be null. See the Status Object documentation for additional information about possible values. |
Status |
None. |
StatusText |
The Volunteer Opportunity's Status. |
string |
None. |
CanSignUpViaApi |
Tells whether a user can Volunteer for this Opportunity via the API. |
boolean |
None. |
ApplicationStatus |
The status of the Volunteer Opportunity Application/Sign-up for the current user. |
VolunteerApplicationStatuses |
None. |
ApplicationStatusText |
The Application Status text. |
string |
None. |
VolunteerOpportunityTypeKey |
Indicates the opportunity type that the Volunteer Opportunity is associated with |
globally unique identifier |
None. |
LinkToListOfOpportunities |
Link to reach the volunteer opportunities page |
string |
None. |
PictureUrl |
Thumbnail image src associated to Volunteer Opportunity |
string |
None. |
LinkToOpportunity |
Link to reach the specific Volunteer Opportunity |
string |
None. |
OpportunityName |
Name of the Volunteer Opportunity |
string |
None. |
OpportunityAddress |
Exact Address for the Volunteer Opportunity |
string |
None. |
VolunteerSpotsAvailable |
The number of volunteer spots that are left for the Volunteer Opportunity |
integer |
None. |
Points |
The total points that will be awarded to the Volunteer for the Volunteer Opportunity |
integer |
None. |
VolunteerOpportunityIntegrationCode |
The unique AMS code for this Volunteer Opportunity |
string |
None. |
Response Formats
application/json, text/json
[ { "VolunteerOpportunityKey": "a8faaa70-2303-49ea-8105-30ac61b9cb70", "Title": "sample string 2", "Description": "sample string 3", "Deadline": "sample string 4", "AdditionalRequirements": "sample string 5", "Location": "sample string 6", "VolunteersNeeded": 7, "CreatedOn": "2021-01-15T14:30:16.2387787Z", "CloseDate": "2021-01-15T14:30:16.2387787Z", "UpdatedOn": "2021-01-15T14:30:16.2387787Z", "EstimatedHours": 11.0, "SkillMultiplier": 12.0, "StartDateTime": "2021-01-15T14:30:16.2387787Z", "EndDateTime": "2021-01-15T14:30:16.2387787Z", "Community": { "AllowMemberCreatedEvents": true, "AllowTickets": true, "CanMembersInviteOthers": true, "CommunityKey": "b2bd3ce9-56c8-4eb5-92e9-b1567d65dfb8", "LegacyGroupKey": "sample string 5", "CommunityName": "sample string 6", "CommunitySize": 7, "CommunityType": "sample string 8", "CommunityTypeKey": "ac83162c-2475-4b59-9321-5e4cf88261ac", "CommunityTypeName": "sample string 10", "CreatedByContactKey": "334d9d76-5da7-4ff8-810d-84242d2acc59", "CreatedOn": "2021-01-15T14:30:16.2387787Z", "Description": "sample string 13", "Html": "sample string 14", "IsSubscribedToDiscussion": true, "IsOnCommunitySync": true, "JoinPermissionKey": "26a2e8bc-d30a-40fd-b487-e0ec07f5fc1b", "LibraryKey": "7a51214a-d2d8-4d52-b8da-6fcf570a7856", "LibraryName": "sample string 19", "LinkToCommunity": "sample string 20", "LinkToCommunityCalendar": "sample string 21", "LinkToDiscussion": "sample string 22", "LinkToLibrary": "sample string 23", "LinkToWebsite": "sample string 24", "DiscussionKey": "4d7b80b6-4952-463f-a8f8-a9b551eab925", "DiscussionName": "sample string 26", "MicrositeGroupKey": "933293b2-5c97-431f-8039-80a4ce5d3742", "SiteName": "sample string 28", "ViewPermissionKey": "e9b584bf-b694-40da-a654-1d16b4d44fa5", "Statistics": { "BlogCount": 1, "DocumentCount": 2, "MemberCount": 3, "DiscussionPostCount": 4, "CurrentYearAnnouncementCount": 5, "CurrentYearEventCount": 6, "LastDocumentUpdatedDate": "2021-01-15T14:30:16.2387787Z", "LastMemberJoinedDate": "2021-01-15T14:30:16.2387787Z", "LastPostingDate": "2021-01-15T14:30:16.2387787Z", "LastBlogPublishedDate": "2021-01-15T14:30:16.2387787Z", "LastAnnouncementUpdatedOnDate": "2021-01-15T14:30:16.2387787Z", "LastEventUpdatedOnDate": "2021-01-15T14:30:16.2387787Z", "MaxActivityDate": "2021-01-15T14:30:16.2387787Z", "MinActivityDate": "2021-01-15T14:30:16.2387787Z" }, "CreatedByContact": { "LinkToProfile": "sample string 1", "PictureUrl": "sample string 2", "ContactKey": "60140ca4-18c6-4167-8b78-9352b464e139", "FirstName": "sample string 4", "LastName": "sample string 5", "DisplayName": "sample string 6", "EmailAddress": "sample string 7", "ContactStatusCode": "sample string 8", "PrefixCode": "sample string 9", "UpdatedOn": "2021-01-15T14:30:16.2387787Z", "UpdatedByContactKey": "fc8c2741-aef4-4a79-9b72-15d83b314854", "CompanyName": "sample string 12", "CompanyTitle": "sample string 13", "SuffixCode": "sample string 14", "Designation": "sample string 15", "LegacyContactKey": "sample string 16", "InformalName": "sample string 17", "MiddleName": "sample string 18", "IsCompany": true, "CompanyLegacyContactKey": "sample string 20", "AMSDirectoryOptOut": true, "HLDirectoryOptOut": true, "HLContactMeOptOut": true, "LargePictureUrl": "sample string 24", "AgreedToTermsDateTime": "2021-01-15T14:30:16.2387787Z" }, "IntegrationKey": "sample string 30", "IntegrationTypeKey": "sample string 31", "ParentCommunityKey": "e00274fc-e6d4-4a25-84d1-b804485f2e81" }, "RequiresApproval": true, "Status": 0, "StatusText": "sample string 16", "CanSignUpViaApi": true, "ApplicationStatus": 0, "ApplicationStatusText": "sample string 18", "VolunteerOpportunityTypeKey": "e074f05f-ab13-4812-9905-9cc78756b3bc", "LinkToListOfOpportunities": "sample string 20", "PictureUrl": "sample string 21", "LinkToOpportunity": "sample string 22", "OpportunityName": "sample string 23", "OpportunityAddress": "sample string 24", "VolunteerSpotsAvailable": 25, "Points": 26, "VolunteerOpportunityIntegrationCode": "sample string 27" }, { "VolunteerOpportunityKey": "a8faaa70-2303-49ea-8105-30ac61b9cb70", "Title": "sample string 2", "Description": "sample string 3", "Deadline": "sample string 4", "AdditionalRequirements": "sample string 5", "Location": "sample string 6", "VolunteersNeeded": 7, "CreatedOn": "2021-01-15T14:30:16.2387787Z", "CloseDate": "2021-01-15T14:30:16.2387787Z", "UpdatedOn": "2021-01-15T14:30:16.2387787Z", "EstimatedHours": 11.0, "SkillMultiplier": 12.0, "StartDateTime": "2021-01-15T14:30:16.2387787Z", "EndDateTime": "2021-01-15T14:30:16.2387787Z", "Community": { "AllowMemberCreatedEvents": true, "AllowTickets": true, "CanMembersInviteOthers": true, "CommunityKey": "b2bd3ce9-56c8-4eb5-92e9-b1567d65dfb8", "LegacyGroupKey": "sample string 5", "CommunityName": "sample string 6", "CommunitySize": 7, "CommunityType": "sample string 8", "CommunityTypeKey": "ac83162c-2475-4b59-9321-5e4cf88261ac", "CommunityTypeName": "sample string 10", "CreatedByContactKey": "334d9d76-5da7-4ff8-810d-84242d2acc59", "CreatedOn": "2021-01-15T14:30:16.2387787Z", "Description": "sample string 13", "Html": "sample string 14", "IsSubscribedToDiscussion": true, "IsOnCommunitySync": true, "JoinPermissionKey": "26a2e8bc-d30a-40fd-b487-e0ec07f5fc1b", "LibraryKey": "7a51214a-d2d8-4d52-b8da-6fcf570a7856", "LibraryName": "sample string 19", "LinkToCommunity": "sample string 20", "LinkToCommunityCalendar": "sample string 21", "LinkToDiscussion": "sample string 22", "LinkToLibrary": "sample string 23", "LinkToWebsite": "sample string 24", "DiscussionKey": "4d7b80b6-4952-463f-a8f8-a9b551eab925", "DiscussionName": "sample string 26", "MicrositeGroupKey": "933293b2-5c97-431f-8039-80a4ce5d3742", "SiteName": "sample string 28", "ViewPermissionKey": "e9b584bf-b694-40da-a654-1d16b4d44fa5", "Statistics": { "BlogCount": 1, "DocumentCount": 2, "MemberCount": 3, "DiscussionPostCount": 4, "CurrentYearAnnouncementCount": 5, "CurrentYearEventCount": 6, "LastDocumentUpdatedDate": "2021-01-15T14:30:16.2387787Z", "LastMemberJoinedDate": "2021-01-15T14:30:16.2387787Z", "LastPostingDate": "2021-01-15T14:30:16.2387787Z", "LastBlogPublishedDate": "2021-01-15T14:30:16.2387787Z", "LastAnnouncementUpdatedOnDate": "2021-01-15T14:30:16.2387787Z", "LastEventUpdatedOnDate": "2021-01-15T14:30:16.2387787Z", "MaxActivityDate": "2021-01-15T14:30:16.2387787Z", "MinActivityDate": "2021-01-15T14:30:16.2387787Z" }, "CreatedByContact": { "LinkToProfile": "sample string 1", "PictureUrl": "sample string 2", "ContactKey": "60140ca4-18c6-4167-8b78-9352b464e139", "FirstName": "sample string 4", "LastName": "sample string 5", "DisplayName": "sample string 6", "EmailAddress": "sample string 7", "ContactStatusCode": "sample string 8", "PrefixCode": "sample string 9", "UpdatedOn": "2021-01-15T14:30:16.2387787Z", "UpdatedByContactKey": "fc8c2741-aef4-4a79-9b72-15d83b314854", "CompanyName": "sample string 12", "CompanyTitle": "sample string 13", "SuffixCode": "sample string 14", "Designation": "sample string 15", "LegacyContactKey": "sample string 16", "InformalName": "sample string 17", "MiddleName": "sample string 18", "IsCompany": true, "CompanyLegacyContactKey": "sample string 20", "AMSDirectoryOptOut": true, "HLDirectoryOptOut": true, "HLContactMeOptOut": true, "LargePictureUrl": "sample string 24", "AgreedToTermsDateTime": "2021-01-15T14:30:16.2387787Z" }, "IntegrationKey": "sample string 30", "IntegrationTypeKey": "sample string 31", "ParentCommunityKey": "e00274fc-e6d4-4a25-84d1-b804485f2e81" }, "RequiresApproval": true, "Status": 0, "StatusText": "sample string 16", "CanSignUpViaApi": true, "ApplicationStatus": 0, "ApplicationStatusText": "sample string 18", "VolunteerOpportunityTypeKey": "e074f05f-ab13-4812-9905-9cc78756b3bc", "LinkToListOfOpportunities": "sample string 20", "PictureUrl": "sample string 21", "LinkToOpportunity": "sample string 22", "OpportunityName": "sample string 23", "OpportunityAddress": "sample string 24", "VolunteerSpotsAvailable": 25, "Points": 26, "VolunteerOpportunityIntegrationCode": "sample string 27" } ]
application/xml, text/xml
<ArrayOfVolunteerOpportunity xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/HigherLogic.API.Models.Enterprise.Volunteer"> <VolunteerOpportunity> <AdditionalRequirements>sample string 5</AdditionalRequirements> <ApplicationStatusText>sample string 18</ApplicationStatusText> <CloseDate>2021-01-15T09:30:16.2387787-05:00</CloseDate> <CreatedOn>2021-01-15T09:30:16.2387787-05:00</CreatedOn> <Deadline>sample string 4</Deadline> <Description>sample string 3</Description> <EndDateTime>2021-01-15T09:30:16.2387787-05:00</EndDateTime> <EstimatedHours>11</EstimatedHours> <LinkToListOfOpportunities>sample string 20</LinkToListOfOpportunities> <LinkToOpportunity>sample string 22</LinkToOpportunity> <Location>sample string 6</Location> <OpportunityAddress>sample string 24</OpportunityAddress> <OpportunityName>sample string 23</OpportunityName> <PictureUrl>sample string 21</PictureUrl> <Points>26</Points> <RequiresApproval>true</RequiresApproval> <SkillMultiplier>12</SkillMultiplier> <StartDateTime>2021-01-15T09:30:16.2387787-05:00</StartDateTime> <StatusText>sample string 16</StatusText> <Title>sample string 2</Title> <UpdatedOn>2021-01-15T09:30:16.2387787-05:00</UpdatedOn> <VolunteerOpportunityKey>a8faaa70-2303-49ea-8105-30ac61b9cb70</VolunteerOpportunityKey> <VolunteerOpportunityTypeKey>e074f05f-ab13-4812-9905-9cc78756b3bc</VolunteerOpportunityTypeKey> <VolunteerSpotsAvailable>25</VolunteerSpotsAvailable> <VolunteersNeeded>7</VolunteersNeeded> </VolunteerOpportunity> <VolunteerOpportunity> <AdditionalRequirements>sample string 5</AdditionalRequirements> <ApplicationStatusText>sample string 18</ApplicationStatusText> <CloseDate>2021-01-15T09:30:16.2387787-05:00</CloseDate> <CreatedOn>2021-01-15T09:30:16.2387787-05:00</CreatedOn> <Deadline>sample string 4</Deadline> <Description>sample string 3</Description> <EndDateTime>2021-01-15T09:30:16.2387787-05:00</EndDateTime> <EstimatedHours>11</EstimatedHours> <LinkToListOfOpportunities>sample string 20</LinkToListOfOpportunities> <LinkToOpportunity>sample string 22</LinkToOpportunity> <Location>sample string 6</Location> <OpportunityAddress>sample string 24</OpportunityAddress> <OpportunityName>sample string 23</OpportunityName> <PictureUrl>sample string 21</PictureUrl> <Points>26</Points> <RequiresApproval>true</RequiresApproval> <SkillMultiplier>12</SkillMultiplier> <StartDateTime>2021-01-15T09:30:16.2387787-05:00</StartDateTime> <StatusText>sample string 16</StatusText> <Title>sample string 2</Title> <UpdatedOn>2021-01-15T09:30:16.2387787-05:00</UpdatedOn> <VolunteerOpportunityKey>a8faaa70-2303-49ea-8105-30ac61b9cb70</VolunteerOpportunityKey> <VolunteerOpportunityTypeKey>e074f05f-ab13-4812-9905-9cc78756b3bc</VolunteerOpportunityTypeKey> <VolunteerSpotsAvailable>25</VolunteerSpotsAvailable> <VolunteersNeeded>7</VolunteersNeeded> </VolunteerOpportunity> </ArrayOfVolunteerOpportunity>