Skip to main content
POST
/
api
/
GiftAsk
/
Query
Query Gift Asks
curl --request POST \
  --url https://api.virtuoussoftware.com/api/GiftAsk/Query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "groups": [
    {
      "conditions": [
        {
          "parameter": "<string:required>",
          "operator": "<string:required>",
          "value": "<string:optional>",
          "secondaryValue": "<string:optional>",
          "values": [
            "<string:optional>",
            "<string:optional>"
          ]
        },
        {
          "parameter": "<string:required>",
          "operator": "<string:required>",
          "value": "<string:optional>",
          "secondaryValue": "<string:optional>",
          "values": [
            "<string:optional>",
            "<string:optional>"
          ]
        }
      ]
    }
  ],
  "sortBy": "<string:optional:default=id>",
  "descending": "<boolean:optional:default=false>"
}
'
{
  "list": [
    {
      "id": "<integer>",
      "giftAskUrl": "<string>",
      "giftsAppliedUrl": "<string>",
      "contactId": "<integer>",
      "contactUrl": "<string>",
      "askAmount": "<double>",
      "askAmountFormatted": "<string>",
      "askDate": "<dateTime>",
      "askDateFormatted": "<string>",
      "expectedFulfillmentDate": "<dateTime>",
      "expectedFulfillmentDateFormatted": "<string>",
      "notes": "<string>",
      "askType": "<string>",
      "frequency": "<string>",
      "declined": "<boolean>",
      "createDateTimeUtc": "<dateTime>",
      "createdByUser": "<string>",
      "modifiedDateTimeUtc": "<dateTime>",
      "modifiedByUser": "<string>",
      "projectId": "<integer>",
      "project": "<string>",
      "projectUrl": "<string>",
      "segmentId": "<integer>",
      "segment": "<string>",
      "segmentCode": "<string>",
      "segmentUrl": "<string>",
      "assignedUserId": "<integer>",
      "assignedUser": "<string>",
      "secondaryAssignedUser": "string",
      "secondaryAssignedUserId": 0,
      "status": "<string>",
      "customFields": [
        {
          "name": "<string>",
          "value": "<string>",
          "displayName": "<string>"
        },
        {
          "name": "<string>",
          "value": "<string>",
          "displayName": "<string>"
        }
      ]
    },
    {
      "id": "<integer>",
      "giftAskUrl": "<string>",
      "giftsAppliedUrl": "<string>",
      "contactId": "<integer>",
      "contactUrl": "<string>",
      "askAmount": "<double>",
      "askAmountFormatted": "<string>",
      "askDate": "<dateTime>",
      "askDateFormatted": "<string>",
      "expectedFulfillmentDate": "<dateTime>",
      "expectedFulfillmentDateFormatted": "<string>",
      "notes": "<string>",
      "askType": "<string>",
      "frequency": "<string>",
      "declined": "<boolean>",
      "createDateTimeUtc": "<dateTime>",
      "createdByUser": "<string>",
      "modifiedDateTimeUtc": "<dateTime>",
      "modifiedByUser": "<string>",
      "projectId": "<integer>",
      "project": "<string>",
      "projectUrl": "<string>",
      "segmentId": "<integer>",
      "segment": "<string>",
      "segmentCode": "<string>",
      "segmentUrl": "<string>",
      "assignedUserId": "<integer>",
      "assignedUser": "<string>",
      "secondaryAssignedUser": "string",
      "secondaryAssignedUserId": 0,
      "status": "<string>",
      "customFields": [
        {
          "name": "<string>",
          "value": "<string>",
          "displayName": "<string>"
        },
        {
          "name": "<string>",
          "value": "<string>",
          "displayName": "<string>"
        }
      ]
    }
  ],
  "total": "<integer>"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

skip
string

The number of records to skip. Default = 0.

take
string

The number of records to take. Default = 10. Max is 1000.

Body

application/json
groups
object[]
sortBy
string
descending
string<style>

Response

OK

list
object[]
total
string
Last modified on June 5, 2026