List

List all Hire Group Campaigns.

Request

GET https://ttv.microworkers.com/api/v2/hire-group-campaigns

Parameters

Query Parameters    
Name Type Description
pageSize integer The maximum number of Campaigns to include in the response, used for paging. Default: 10.
sort string Results may be sorted by: id, title, created. Default: -created.
nextPageToken string The pagination token used to get the next page of results, set this parameter to the value of “nextPageToken” from the previous response.
filter[folder] string Filter campaigns by folder. Allowed values: DEFAULT, ARCHIVE.
filter[created][op] string

Filter Campaigns by creation date operator. Required, if filter[created][value] provided. Allowed values: gt, gte, lt, lte, between.

  • gt - Greater than.
  • gte - Greater than or equal.
  • lt - Less than.
  • lte - Less than or equal.
  • between - In range.
filter[created][value] string

Filter Campaigns by creation date value. Required, if filter[created][op] provided.

  • Value should be in format yyyy-mm-ddThh:mm:ss+00:00 if filter[created][op] is one of gt, gte, lt, lte.
  • Value should be in format yyyy-mm-ddThh:mm:ss+00:00..yyyy-mm-ddThh:mm:ss+00:00 if filter[created][op] is between.

Response

Response HTTP Codes

Http Code Response Type Description
200 HireGroupCampaignListResponse OK
401   Unauthorized

Response Body

{
  "items": [
    {
      "maxPositionPerWorker": integer,
      "groupId": string,
      "categoryId": string,
      "id": string,
      "autoSkipTask": {
        "enabled": boolean,
        "timeLimit": integer
      },
      "title": string,
      "description": string,
      "folder": string,
      "ttr": integer,
      "availablePositions": integer,
      "blockedReason": string,
      "status": string,
      "created": datetime,
      "blocked": datetime,
      "approved": datetime,
      "finished": datetime,
      "htmlCode": string,
      "minutesToFinish": integer,
      "paymentPerTask": float,
      "variables": [
        string
      ],
      "questions": [
        {
          "id": string,
          "name": string,
          "required": boolean,
          "tag": string
        }
      ],
      "jobQueues": {
        "csvUploadJob": {
          "id": string,
          "status": string,
          "output": string
        },
        "restartCampaignJob": {
          "id": string,
          "status": string,
          "output": string
        },
        "addPositionJob": {
          "id": string,
          "status": string,
          "output": string
        }
      },
      "qtRequired": boolean,
      "internalTemplate": {
        "adminInstructions": string,
        "numberOfSubTasks": integer,
        "displaySubTasksOnSamePage": boolean,
        "ratingMethodId": integer,
        "id": string,
        "numberOfFileProofs": integer,
        "allowedFileTypes": [
          string
        ]
      },
      "externalTemplate": {
        "url": string,
        "height": string,
        "width": string,
        "parameters": [
          string
        ]
      },
      "maximumJobLimit": {
        "enabled": boolean,
        "limitPerDay": integer
      },
      "slotsCount": {
        "locked": integer,
        "unTaken": integer,
        "ok": integer,
        "nok": integer,
        "notRated": integer,
        "notReviewed": integer,
        "revise": integer,
        "reviseAdmin": integer
      },
      "notificationSettings": [
        {
          "url": string,
          "type": string,
          "notificationTypes": [
            string
          ]
        }
      ]
    }
  ],
  "nextPageToken": string,
  "perPage": integer
}

HireGroupCampaignListResponse

Property Type Description
items array[HireGroupCampaignInfoResponse] List of Campaigns.
perPage integer The number of items per page.
nextPageToken string The pagination token of next page of results.