GET api/v1/Commitments/User/{userID}

Gets the commitments for a specific user. The logged in user should either share a team, or be in one one of the target user's parent teams, or an admin level user. The default date range returns this week and three weeks forward.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
userID

globally unique identifier

Required

startDate

The start date. If null it will use the default start date

date

None.

endDate

The end date. If null it will use the default end date

date

None.

q

A query parameter. Use this to limit the result set. ?q[fieldName1]=value1&q[fieldName2]=value2

Dictionary of string [key] and string [value]

None.

limit

The number of records returned, default is 20

integer

None.

offset

The offset from the start of the list of values, default is 0

integer

None.

orderBy

Orders the list that comes down to the field name provided. If not provided then the default ordering will be used.

string

None.

fields

Use this to only return the data fields you're interested in. Field names not found are ignored and no error is thrown. If no fields are found then the full object is returned.

Collection of string

None.

suppressResponseCodes

Some applications do wonky things if error codes are used. Use this to force 200s to always return.

boolean

None.

APIKey

This is your unique key that identifies you as the developer of this app. Required for all calls.

string

None.

APIToken

This is the user's session token generated when you authenticate the user

string

None.

Body Parameters

None.

Response Information

Resource Description

PaginatedResultsOfCommitment
NameDescriptionTypeAdditional information
limit

integer

None.

offset

integer

None.

totalRecordCount

integer

None.

data

Collection of Commitment

None.

Response Formats

application/json, text/json

Sample:
{
  "limit": 1,
  "offset": 2,
  "totalRecordCount": 3,
  "data": [
    {
      "ID": "ae91ef82-68cf-4e52-acbe-43d11391b4a7",
      "Text": "sample string 2",
      "Completed": true,
      "PeriodStartDate": "2024-05-19T09:40:39.7312129-04:00",
      "GoalID": "098ddb40-8cdc-49c9-aa7a-e0fc5d7aee3d",
      "TeamID": "67eb93c6-7daa-4c9b-9c52-1aecf9834274",
      "UserID": "a110ff82-066b-41c1-91a2-15cddba88f5c"
    },
    {
      "ID": "ae91ef82-68cf-4e52-acbe-43d11391b4a7",
      "Text": "sample string 2",
      "Completed": true,
      "PeriodStartDate": "2024-05-19T09:40:39.7312129-04:00",
      "GoalID": "098ddb40-8cdc-49c9-aa7a-e0fc5d7aee3d",
      "TeamID": "67eb93c6-7daa-4c9b-9c52-1aecf9834274",
      "UserID": "a110ff82-066b-41c1-91a2-15cddba88f5c"
    }
  ]
}