GET api/v2.0/Volunteer/GetUpcomingVolunteerOpportunities?opportunityTypeKey={opportunityTypeKey}&communityKey={communityKey}&maxToRetrieve={maxToRetrieve}

Returns Upcoming VolunteerOpportunies for Current User.

Request Information

URI Parameters

NameDescriptionTypeAdditional 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 VolunteerOpportunity
NameDescriptionTypeAdditional 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

Sample: 
[
  {
    "VolunteerOpportunityKey": "3bdf3c6d-1ab9-49f4-83a4-01f93646ab21",
    "Title": "sample string 2",
    "Description": "sample string 3",
    "Deadline": "sample string 4",
    "AdditionalRequirements": "sample string 5",
    "Location": "sample string 6",
    "VolunteersNeeded": 7,
    "CreatedOn": "2020-02-23T01:07:23.2937595Z",
    "CloseDate": "2020-02-23T01:07:23.2937595Z",
    "UpdatedOn": "2020-02-23T01:07:23.2937595Z",
    "EstimatedHours": 11.0,
    "SkillMultiplier": 12.0,
    "StartDateTime": "2020-02-23T01:07:23.2937595Z",
    "EndDateTime": "2020-02-23T01:07:23.2937595Z",
    "Community": {
      "AllowMemberCreatedEvents": true,
      "AllowTickets": true,
      "CanMembersInviteOthers": true,
      "CommunityKey": "d927c286-078d-4aa9-b9ac-e69867652231",
      "LegacyGroupKey": "sample string 5",
      "CommunityName": "sample string 6",
      "CommunitySize": 7,
      "CommunityType": "sample string 8",
      "CommunityTypeKey": "5d998850-c450-45ea-87cc-71c40de6ec5c",
      "CommunityTypeName": "sample string 10",
      "CreatedByContactKey": "823d9aef-2da0-401e-9aa3-7ff82faabee2",
      "CreatedOn": "2020-02-23T01:07:23.2937595Z",
      "Description": "sample string 13",
      "Html": "sample string 14",
      "IsSubscribedToDiscussion": true,
      "IsOnCommunitySync": true,
      "JoinPermissionKey": "0bf1a6c8-4929-48c0-9fb8-601b19307e66",
      "LibraryKey": "5c2d0993-f6da-4d68-9f01-9bdc82d16db7",
      "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": "9dec8cb6-a27e-4462-8dc1-4e5d3ffec746",
      "DiscussionName": "sample string 26",
      "MicrositeGroupKey": "1c9c77fa-733d-4c2c-9131-f711afdeadc6",
      "SiteName": "sample string 28",
      "ViewPermissionKey": "30e0a441-74e6-4128-8537-0d01cd1682cc",
      "Statistics": {
        "BlogCount": 1,
        "DocumentCount": 2,
        "MemberCount": 3,
        "DiscussionPostCount": 4,
        "CurrentYearAnnouncementCount": 5,
        "CurrentYearEventCount": 6,
        "LastDocumentUpdatedDate": "2020-02-23T01:07:23.2937595Z",
        "LastMemberJoinedDate": "2020-02-23T01:07:23.2937595Z",
        "LastPostingDate": "2020-02-23T01:07:23.2937595Z",
        "LastBlogPublishedDate": "2020-02-23T01:07:23.2937595Z",
        "LastAnnouncementUpdatedOnDate": "2020-02-23T01:07:23.2937595Z",
        "LastEventUpdatedOnDate": "2020-02-23T01:07:23.2937595Z",
        "MaxActivityDate": "2020-02-23T01:07:23.2937595Z",
        "MinActivityDate": "2020-02-23T01:07:23.2937595Z"
      },
      "CreatedByContact": {
        "LinkToProfile": "sample string 1",
        "PictureUrl": "sample string 2",
        "ContactKey": "e4d49d8e-d1aa-4fcb-aa43-7bebf477bd27",
        "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": "2020-02-23T01:07:23.2937595Z",
        "UpdatedByContactKey": "011e5fcf-80f4-4f14-8f41-82535657b7a2",
        "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": "2020-02-23T01:07:23.2937595Z"
      },
      "IntegrationKey": "sample string 30",
      "IntegrationTypeKey": "sample string 31",
      "ParentCommunityKey": "77b36f46-6c06-4b8e-9d77-ed449965a60c"
    },
    "RequiresApproval": true,
    "Status": 0,
    "StatusText": "sample string 16",
    "CanSignUpViaApi": true,
    "ApplicationStatus": 0,
    "ApplicationStatusText": "sample string 18",
    "VolunteerOpportunityTypeKey": "e8cafeb6-7d81-4b4d-b0a5-76b6a6c9ccde",
    "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": "3bdf3c6d-1ab9-49f4-83a4-01f93646ab21",
    "Title": "sample string 2",
    "Description": "sample string 3",
    "Deadline": "sample string 4",
    "AdditionalRequirements": "sample string 5",
    "Location": "sample string 6",
    "VolunteersNeeded": 7,
    "CreatedOn": "2020-02-23T01:07:23.2937595Z",
    "CloseDate": "2020-02-23T01:07:23.2937595Z",
    "UpdatedOn": "2020-02-23T01:07:23.2937595Z",
    "EstimatedHours": 11.0,
    "SkillMultiplier": 12.0,
    "StartDateTime": "2020-02-23T01:07:23.2937595Z",
    "EndDateTime": "2020-02-23T01:07:23.2937595Z",
    "Community": {
      "AllowMemberCreatedEvents": true,
      "AllowTickets": true,
      "CanMembersInviteOthers": true,
      "CommunityKey": "d927c286-078d-4aa9-b9ac-e69867652231",
      "LegacyGroupKey": "sample string 5",
      "CommunityName": "sample string 6",
      "CommunitySize": 7,
      "CommunityType": "sample string 8",
      "CommunityTypeKey": "5d998850-c450-45ea-87cc-71c40de6ec5c",
      "CommunityTypeName": "sample string 10",
      "CreatedByContactKey": "823d9aef-2da0-401e-9aa3-7ff82faabee2",
      "CreatedOn": "2020-02-23T01:07:23.2937595Z",
      "Description": "sample string 13",
      "Html": "sample string 14",
      "IsSubscribedToDiscussion": true,
      "IsOnCommunitySync": true,
      "JoinPermissionKey": "0bf1a6c8-4929-48c0-9fb8-601b19307e66",
      "LibraryKey": "5c2d0993-f6da-4d68-9f01-9bdc82d16db7",
      "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": "9dec8cb6-a27e-4462-8dc1-4e5d3ffec746",
      "DiscussionName": "sample string 26",
      "MicrositeGroupKey": "1c9c77fa-733d-4c2c-9131-f711afdeadc6",
      "SiteName": "sample string 28",
      "ViewPermissionKey": "30e0a441-74e6-4128-8537-0d01cd1682cc",
      "Statistics": {
        "BlogCount": 1,
        "DocumentCount": 2,
        "MemberCount": 3,
        "DiscussionPostCount": 4,
        "CurrentYearAnnouncementCount": 5,
        "CurrentYearEventCount": 6,
        "LastDocumentUpdatedDate": "2020-02-23T01:07:23.2937595Z",
        "LastMemberJoinedDate": "2020-02-23T01:07:23.2937595Z",
        "LastPostingDate": "2020-02-23T01:07:23.2937595Z",
        "LastBlogPublishedDate": "2020-02-23T01:07:23.2937595Z",
        "LastAnnouncementUpdatedOnDate": "2020-02-23T01:07:23.2937595Z",
        "LastEventUpdatedOnDate": "2020-02-23T01:07:23.2937595Z",
        "MaxActivityDate": "2020-02-23T01:07:23.2937595Z",
        "MinActivityDate": "2020-02-23T01:07:23.2937595Z"
      },
      "CreatedByContact": {
        "LinkToProfile": "sample string 1",
        "PictureUrl": "sample string 2",
        "ContactKey": "e4d49d8e-d1aa-4fcb-aa43-7bebf477bd27",
        "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": "2020-02-23T01:07:23.2937595Z",
        "UpdatedByContactKey": "011e5fcf-80f4-4f14-8f41-82535657b7a2",
        "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": "2020-02-23T01:07:23.2937595Z"
      },
      "IntegrationKey": "sample string 30",
      "IntegrationTypeKey": "sample string 31",
      "ParentCommunityKey": "77b36f46-6c06-4b8e-9d77-ed449965a60c"
    },
    "RequiresApproval": true,
    "Status": 0,
    "StatusText": "sample string 16",
    "CanSignUpViaApi": true,
    "ApplicationStatus": 0,
    "ApplicationStatusText": "sample string 18",
    "VolunteerOpportunityTypeKey": "e8cafeb6-7d81-4b4d-b0a5-76b6a6c9ccde",
    "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

Sample: 
<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>2020-02-22T20:07:23.2937595-05:00</CloseDate>
    <CreatedOn>2020-02-22T20:07:23.2937595-05:00</CreatedOn>
    <Deadline>sample string 4</Deadline>
    <Description>sample string 3</Description>
    <EndDateTime>2020-02-22T20:07:23.2937595-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>2020-02-22T20:07:23.2937595-05:00</StartDateTime>
    <StatusText>sample string 16</StatusText>
    <Title>sample string 2</Title>
    <UpdatedOn>2020-02-22T20:07:23.2937595-05:00</UpdatedOn>
    <VolunteerOpportunityKey>3bdf3c6d-1ab9-49f4-83a4-01f93646ab21</VolunteerOpportunityKey>
    <VolunteerOpportunityTypeKey>e8cafeb6-7d81-4b4d-b0a5-76b6a6c9ccde</VolunteerOpportunityTypeKey>
    <VolunteerSpotsAvailable>25</VolunteerSpotsAvailable>
    <VolunteersNeeded>7</VolunteersNeeded>
  </VolunteerOpportunity>
  <VolunteerOpportunity>
    <AdditionalRequirements>sample string 5</AdditionalRequirements>
    <ApplicationStatusText>sample string 18</ApplicationStatusText>
    <CloseDate>2020-02-22T20:07:23.2937595-05:00</CloseDate>
    <CreatedOn>2020-02-22T20:07:23.2937595-05:00</CreatedOn>
    <Deadline>sample string 4</Deadline>
    <Description>sample string 3</Description>
    <EndDateTime>2020-02-22T20:07:23.2937595-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>2020-02-22T20:07:23.2937595-05:00</StartDateTime>
    <StatusText>sample string 16</StatusText>
    <Title>sample string 2</Title>
    <UpdatedOn>2020-02-22T20:07:23.2937595-05:00</UpdatedOn>
    <VolunteerOpportunityKey>3bdf3c6d-1ab9-49f4-83a4-01f93646ab21</VolunteerOpportunityKey>
    <VolunteerOpportunityTypeKey>e8cafeb6-7d81-4b4d-b0a5-76b6a6c9ccde</VolunteerOpportunityTypeKey>
    <VolunteerSpotsAvailable>25</VolunteerSpotsAvailable>
    <VolunteersNeeded>7</VolunteersNeeded>
  </VolunteerOpportunity>
</ArrayOfVolunteerOpportunity>