---
title: "List Campaigns"
method: GET
path: "/campaigns"
tags: ["Campaigns / Entity"]
---

# List Campaigns

`GET /campaigns`

## Request

- Base URL: `https://api.forcemanager.com/api/v4`
- URL: `https://api.forcemanager.com/api/v4/campaigns`
- Auth: API key in header `X-Session-Key`

Returns all Campaigns available in the user's ForceManager implementation database.

You will only receive the List of Campaigns after first providing the Session Key. To know how you can obtain the Session Key, [go to Authentication](#tag/authentication/POST/login).

**HEADERS**

| **Parameter** | **Value** | **Description** |
| --- | --- | --- |
| Content-Type | application/json | Language in which all request and response bodies are encoded |
| Accept | \*/\* | Any data of whatever mime type is accepted |
| X-Session-Key | AUTH_TOKEN | This field must be completed with the token obtained at the authentication |
| Count | {number} | The number of records to return in each page of results. The default page limit is 50 |
| ExtraFieldDescription | {number} | If equal to "0", the response returns only the value of each Extra Fields, if equal to "1" also the description is returned |

**REQUEST**

You can apply filters. The order of the parameters does not matter.

| **Parameter** | **Type** | **Description** |
| --- | --- | --- |
| offset | Integer | Define position from which the records must be returned |
| count | Integer | Define the number of results to return |

e.g.

```
https://api.forcemanager.com/api/v4/campaigns?offset=VALUE&count=VALUE

 ```

**RESPONSE**

This endpoint returns information about all Campaigns available in the database.

If you didn't apply any page or count number in the header the default number of records in the response is 50.

List of the supported Campaigns attributes:

| **Attribute** | **Type** | **Description** |
| --- | --- | --- |
| title | String | A short descriptive name for the specific Campaign |
| description | String | A longer description of the Campaign content, it can be also HTML |
| videoUrl | String | A link to a video that describe the sales Campaign |
| address2 | String | Second address to whom the Campaign is linked |
| startDate | String | Date in wich the Campaign starts |
| endDate | String | Date when the Campaign ends |
| ownerId | Integer | Unique identifier of the User associated to the Campaign (see [Users](#) resource) |
| typeId | Integer | Type of the Campaign (see [Types](#) resource) |
| statusId | Integer | Status of the Campaign (see [Statues](#) resource) |
| dateCreated | String | Date and time when the Campaign was created |
| dateDeleted | String | Date and time when the Campaign was deleted |
| dateUpdated | String | Date and time when the Campaign was last updated |
| deleted | Boolean | If true, the Campaign has been deleted and archived |
| id | Integer | Unique identifier for the Campaign in ForceManager |
| salesRepIdCreated | Integer | Unique identifier of the User who created the Campaign |
| salesRepIdDeleted | Integer | Unique identifier of the User who deleted the Campaign |
| salesRepIdUpdated | Integer | Unique identifier of the User who updated the Campaign |

**RESPONSE CODES**

| **Status** | **Description** |
| --- | --- |
| 200 OK | Shows if operation succeeded |
| 400 Bad Request | Shows when an invalid request or the requested service is not available |

## Headers

- `Accept` string
- `Count` string
- `ExtraFieldDescription` string

## Response `200`

List Campaigns

---

[API](https://skmtc.dev/forcemanager/apis/sage-sales-management-public-api-documentation-for-developer.md) · [All operations](https://skmtc.dev/forcemanager/apis/sage-sales-management-public-api-documentation-for-developer/llms.txt) · [OpenAPI document](https://skmtc.dev/forcemanager/apis/sage-sales-management-public-api-documentation-for-developer/revisions/87db17204e2f?raw)