Guusto Gifts API (1.0)

Resources that enables seamless integration with Guusto’s recognition platform, allowing you to send gifts, track gift statuses, manage recipient details and many more with ease.

Languages
Servers
Mock server
https://docs.guusto.com/_mock/version/openapi/
Demo Test Environment
https://api-demo.guusto.io/
Production Environment
https://api.guusto.com/

Account Budget

Operation for querying Workspace account budget

Operations

Order Gift

Operations for creating and managing gift orders

Operations

Reports

Operations for reporting insights and analytics

Operations

Get activities

Request

Query a Workspace activity. This resource supports pagination

Query
requestobject(PageableRequest)required

Request object to specify the pageable response

request.​pageinteger(int32)>= 0

Query result page

Example: 1
request.​sizeinteger(int32)[ 1 .. 50 ]

Query size result per page

Example: 25
Headers
X-Workspace-idstringrequired

Workspace ID for authentication

Example: 444
curl -i -X GET \
  'https://docs.guusto.com/_mock/version/openapi/api/v1/reports/teams/activity?page=1&size=25' \
  -H 'Authorization: Bearer <YOUR_ApiToken_HERE>' \
  -H 'X-Workspace-id: 444'

Responses

Successful Query

Bodyapplication/json
pageinteger(int32)

Selected page for viewing

Example: 1
sizeinteger(int32)

Size of results per page

Example: 50
totalElementsinteger(int64)

Total amount of elements within query

Example: 1
totalPagesinteger(int32)

Total amount of pages within query

Example: 1
activitiesArray of objects(ActivityResponse)

List of workspace activities

Response
application/json
{
  "page": 1,
  "size": 1,
  "totalElements": 2,
  "totalPages": 1,
  "activities": [
    {
      "status": "PENDING",
      "sender": {
        "id": 123332,
        "email": "aldrin.ca@example.io",
        "firstName": "Aldrin",
        "lastName": "Ca",
        "image": "www.image.io/example2.png",
        "self": false
      },
      "receiver": {
        "id": 1233,
        "email": "david.lu@example.io",
        "firstName": "David",
        "lastName": "Lu",
        "image": "www.image.io/example.png",
        "self": false
      },
      "createdOn": "2025-04-02T12:39:24.356313",
      "description": "What an achievement!",
      "reason": {
        "id": 33,
        "description": "Team Lead"
      },
      "isPrivate": false,
      "type": "SHOUTOUT",
      "account": 12323,
      "team": 765
    },
    {
      "status": "APPROVED",
      "sender": {
        "id": 123332,
        "email": "aldrin.ca@example.io",
        "firstName": "Aldrin",
        "lastName": "Ca",
        "image": "www.image.io/example2.png",
        "self": false
      },
      "receiver": {
        "id": 1233,
        "email": "ericJ@example.io",
        "firstName": "Eric",
        "lastName": "Jupiter",
        "image": "www.example2.io/example.png",
        "self": false
      },
      "createdOn": "2025-03-30T12:39:24.356351",
      "description": "What an achievement!",
      "reason": {
        "id": 33,
        "description": "Team Lead"
      },
      "isPrivate": false,
      "type": "SHOUTOUT",
      "account": 12323,
      "team": 765
    }
  ]
}

Get last recognized by manager

Request

Manager Insights - Query employees and the last time they were recognized by their managers. This resource supports pagination.

Query
requestobject(LastRecognizedTeamMemberRequest)required

Request object for querying a Workspace recent recognized member data.

request.​pageinteger(int32)>= 0

Query result page

Example: 1
request.​sizeinteger(int32)[ 1 .. 50 ]

Query size result per page

Example: 25
request.​employeeNumberstringrequired

Employee number to target

Example: "23412"
request.​managerstring

Manager id to target

Example: "23412"
request.​currencystringrequired

Currency to target

Enum"CAD""USD"
Example: "CAD"
request.​departmentstring

Department to target

Example: "Engineering"
request.​locationstring

Location to target

Example: "Vancouver"
request.​costCentrestring

Cost Center to target

Example: "CC002"
Headers
X-Workspace-idstringrequired

Workspace ID for authentication

Example: 444
curl -i -X GET \
  'https://docs.guusto.com/_mock/version/openapi/api/v1/reports/members/last-recognized?costCentre=CC002&currency=CAD&department=Engineering&employeeNumber=23412&location=Vancouver&manager=23412&page=1&size=25' \
  -H 'Authorization: Bearer <YOUR_ApiToken_HERE>' \
  -H 'X-Workspace-id: 444'

Responses

Successful Query

Bodyapplication/json
pageinteger(int32)

Selected page for viewing

Example: 1
sizeinteger(int32)

Size of results per page

Example: 50
totalElementsinteger(int64)

Total amount of elements within query

Example: 1
totalPagesinteger(int32)

Total amount of pages within query

Example: 1
teamMembersArray of objects(PaginateLastRecognizedTeamMemberResponseItem)

List of Workspace members recognized

Response
application/json
{
  "page": 1,
  "size": 1,
  "totalElements": 2,
  "totalPages": 1,
  "teamMembers": [
    {
      "teamMember": {
        "email": "john.doe@example.com",
        "firstName": "John",
        "lastName": "Doe"
      },
      "lastDate": "2025-04-02",
      "type": "SHOUTOUT"
    },
    {
      "teamMember": {
        "email": "Jimmy2@example.com",
        "firstName": "Jim",
        "lastName": "Bob"
      },
      "lastDate": "2025-03-30",
      "type": "GIFT"
    }
  ]
}