Skip to main content

Volunteers

This object represents a volunteer application within a convention.

Retrieve a user's volunteer record​

Returns the volunteer object for the specified user.

Authentication

Service Integration with volunteer:read scope.

Response

link
idstring
The unique identifier of the volunteer record.
link
createdAtISO-8601 Date
The date the volunteer record was created.
link
updatedAtISO-8601 Date
The date the volunteer record was last updated.
link
contactMethodsArray of ContactMethod
Set of contact methods provided by the volunteer.
Show child attributes
link
namestring
The name of the contact method.
link
isPrimaryboolean
Whether this contact method is the preferred way of contacting the volunteer.
link
valuestring
An arbitrary string identifier for the contact method.
link
departmentsArray of DepartmentAssignment
Set of departments where the volunteer has expressed a preference or has an assignment.
Show child attributes
link
idstring
The unique identifier of the department.
link
statesArray of strings
The flags indicating the volunteer's preference or assignment for the department.
Possible values: experience, interest, avoid, assignment, request
link
namestring
The name of the department.
link
userUser
The user object for the volunteer.
Show child attributes
link
idstring
The unique identifier of the user.
link
firstNamestring
The first name of the user.
link
lastNamestring
The last name of the user.
link
usernamestring
The username of the user.
link
preferredNamestring (optional)
nullable
The preferred name of the user. If provided, this should be used instead of the first and last name, except where legally required.
link
phonestring
The phone number of the user in E.164 format.
link
emailstring
The email address of the user.
link
optionsArray of Option
A set of options, customized by the event, that contain arbitrary data provided by the volunteer.
Show child attributes
link
namestring
The name of the option as defined by the event.
link
typestring
The type of the option as defined by the event.
Possible values: select, multi, text, number.
link
valuenumber, string, or Array of string
The value of the option.
GET /api/v0/users/:id/volunteercURL
curl https://reg.cces.dev/api/v0/users/{id}/volunteer \
  -H "Authorization: Bearer <token>"
Responseapplication/json
{
  "id": "1234",
  "createdAt": "2020-01-01T00:00:00Z",
  "updatedAt": "2020-01-01T00:00:00Z",
  "contactMethods": [
    {
      "name": "discord",
      "isPrimary": true,
      "value": "Username#1234"
    },
  ],
  "departments": [
    {
      "id": "1234",
      "states": ["experience", "interest"],
      "name": "Registration"
    },
    {
      "id": "5678",
      "states": ["avoid"]
    }
  ],
  "user": {
    "id": "1234",
    "firstName": "John",
    "lastName": "Doe",
    "username": "jdoe",
    "preferredName": "Johnny",
    "phone": "+15555555555",
    "email": "johnny.test@concat.systems",
  },
  "options": [
    {
      "name": "jump",
      "type": "select",
      "value": "How high?"
    },
  ]
}