List all campaigns

GET /campaigns

This endpoint retrieves all the campaigns.

Query parameters

  • offset integer

    Specify the ranking number of the first item on the page. Used for pagination.

  • limit integer

    Specify how many results to return. Default is 50 campaigns, maximum is 100 campaigns.

    Maximum value is 100. Default value is 50.

  • Specify if the archived campaigns should be included or not. Default is false.

    Default value is false.

Responses

  • 200 application/json

    List of campaigns.

    Hide response attributes Show response attributes object
    • _id string

      Unique identifier for the campaign

    • name string

      Name of the campaign

    • createdAt string(date-time)

      Creation date of the campaign

    • status string

      Status of the campaign

      Values are open, closed, or archived.

    • count object
      Hide count attributes Show count attributes object
      • request integer

        Number of request made

      • open integer

        Number of open requests

      • done integer

        Number of done requests

      • due integer

        Number of due requests

      • waiting integer

        Number of requests waiting for validation

      • error integer

        Number of requests with errors

      • message integer

        Number of message requests

  • Bad Request -- Your request is invalid.

  • Unauthorized -- Your API key is wrong.

  • Forbidden -- The object requested is hidden for administrators only.

  • Not Found -- The specified object could not be found.

  • Too Many Requests -- You're requesting too many objects! Slow down!

  • Internal Server Error -- We had a problem with our server. Try again later.

  • Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

GET /campaigns
curl \
 -X GET https://api.usecollect.com/v1/campaigns
Response examples (200)
[
  {
    "_id": "mYCsdgB4DQoENBaX6",
    "name": "ERC application",
    "count": {
      "due": 5,
      "done": 61,
      "open": 4,
      "error": 0,
      "message": 0,
      "request": 72,
      "waiting": 2
    },
    "status": "open",
    "createdAt": "2022-11-22T13:28:08Z"
  },
  {
    "_id": "wFndw23xmx5RdWrFX",
    "name": "Company KYC",
    "count": {
      "due": 0,
      "done": 18,
      "open": 4,
      "error": 0,
      "message": 0,
      "request": 22,
      "waiting": 0
    },
    "status": "open",
    "createdAt": "2023-01-31T09:49:25Z"
  }
]