List campaigns

Retrieve a paginated list of campaigns.

GET /v1/campaigns

List campaigns

cURL

curl --request GET \
  --url https://app.loops.so/api/v1/campaigns \
  --header 'Authorization: Bearer <token>'

Response

{
  "success": true,
  "pagination": {
    "totalResults": 2,
    "returnedResults": 2,
    "perPage": 20,
    "totalPages": 1,
    "nextCursor": null,
    "nextPage": null
  },
  "data": [
    {
      "campaignId": "cmp_01hxyz",
      "emailMessageId": "em_01hxyz",
      "name": "Spring announcement",
      "subject": "Big spring updates",
      "status": "Draft",
      "createdAt": "2026-03-28T15:00:00.000Z",
      "updatedAt": "2026-03-28T15:00:00.000Z"
    }
  ]
}

Content API endpoints are currently in an open alpha and are subject to change.

Request

Query parameters

perPage · string · default: 20

How many results to return in each request. Must be between 10 and 50.

cursor · string

A cursor to return a specific page of results. Cursors can be found from the pagination.nextCursor value in each response.

Response

Success

success · boolean · required

pagination · object

Show metadata

totalResults · number

Total results found.

returnedResults · number

The number of results returned in this response.

perPage · number

The maximum number of results requested.

totalPages · number

Total number of pages.

nextCursor · nullable string

The next cursor (for retrieving the next page of results using the cursor parameter), or null if there are no further pages.

nextPage · nullable string

The URL of the next page of results, or null if there are no further pages.

data · array · required

Hide campaign

campaignId · string · required

The campaign ID.

emailMessageId · nullable string · required

The associated email message ID.

name · string · required

The campaign name.

subject · string · required

The campaign subject line.

status · string · required

Campaign lifecycle status (for example Draft, Scheduled, Sending, Sent).

createdAt · string · required

ISO 8601 timestamp for when the campaign was created.

updatedAt · string · required

ISO 8601 timestamp for when the campaign was last updated.

Error

If perPage is invalid, a 400 Bad Request is returned.

If the API key is invalid (or content API is not enabled for your team), a 401 Unauthorized is returned.

success · boolean · required

message · string · required

An error message describing what went wrong.

Response

{
  "success": true,
  "pagination": {
    "totalResults": 2,
    "returnedResults": 2,
    "perPage": 20,
    "totalPages": 1,
    "nextCursor": null,
    "nextPage": null
  },
  "data": [
    {
      "campaignId": "cmp_01hxyz",
      "emailMessageId": "em_01hxyz",
      "name": "Spring announcement",
      "subject": "Big spring updates",
      "status": "Draft",
      "createdAt": "2026-03-28T15:00:00.000Z",
      "updatedAt": "2026-03-28T15:00:00.000Z"
    }
  ]
}