> ## Documentation Index
> Fetch the complete documentation index at: https://developer.sendoso.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get All Campaigns

> Retrieve a list of all active campaigns associated to the organization.

### Parameters

<ParamField query="page" type="integer">
  The page number of the results you want to retrieve (the first page is 1). See [Pagination](https://developer.sendoso.com/rest-api/overview/pagination) for more information.
</ParamField>

<ParamField query="per_page" type="integer">
  The number of campaigns to be returned per page (max is 100). See [Pagination](https://developer.sendoso.com/rest-api/overview/pagination) for more information.
</ParamField>

<ParamField query="delivery_type" type="string">
  Optional parameter to filter the results by the gift type. Valid options are `mail` which returns all physical item campaigns or `email` which returns all eGift campaigns.
</ParamField>

### Response

<ResponseField name="current_page" type="integer" required>
  The current page being returned (used for pagination purposes).
</ResponseField>

<ResponseField name="per_page" type="integer" required>
  The number of results being returned per page (used for pagination purposes).
</ResponseField>

<ResponseField name="total_posts" type="integer" required>
  The total number of campaigns (used for pagination purposes).
</ResponseField>

<ResponseField name="touches" type="array" required>
  List of campaigns

  <Expandable title="touch" defaultOpen="true">
    <ResponseField name="id" type="integer" required>
      The campaign's identifier.
    </ResponseField>

    <ResponseField name="name" type="string" required>
      The campaign's name.
    </ResponseField>

    <ResponseField name="start_date" type="string" required>
      The campaign's start date (in `ISO 8601` format). Gifts cannot be sent for this campaign before this start date.
    </ResponseField>

    <ResponseField name="end_date" type="string">
      The campaign's end date (in `ISO 8601` format). Gifts cannot be sent for this campaign after this end date.
    </ResponseField>

    <ResponseField name="description" type="string" required>
      The campaign's description.
    </ResponseField>

    <ResponseField name="created_at" type="string" required>
      The campaign's creation date (in `ISO 8601` format).
    </ResponseField>

    <ResponseField name="user_id" type="integer" required>
      The identifier of the user that created this campaign.
    </ResponseField>

    <ResponseField name="gift_id" type="integer" required>
      The campaign's general gift identifier.
    </ResponseField>

    <ResponseField name="starting_egift_price" type="number">
      The campaign's `starting_egift_price` and `ending_egift_price` represent the range amount from which the sender can pick the egift denominiation to send. Only present for eGift campaigns. When this range is present, `is_default_price` will be false.
    </ResponseField>

    <ResponseField name="ending_egift_price" type="number">
      The campaign's `starting_egift_price` and `ending_egift_price` represent the range amount from which the sender can pick the egift denominiation to send. Only present for eGift campaigns. When this range is present, `is_default_price` will be false.
    </ResponseField>

    <ResponseField name="status" type="string" required>
      The campaign's status. It will ALWAYS be `Active` since this endpoint only returns active campaigns.
    </ResponseField>

    <ResponseField name="is_default_price" type="boolean" required>
      Whether or not the sender can pick the eGift amount from a range or if it is a set price.
    </ResponseField>

    <ResponseField name="delivery_type" type="string" required>
      The type of gift that is associated to this campaign. Valid options are `mail` which means physical item or `email` which means eGift.
    </ResponseField>

    <ResponseField name="hubspot_key" type="string" required>
      The campaign's key to be used for HubSpot integration.
    </ResponseField>

    <ResponseField name="ship_to_countries" type="array" required>
      List of countries that this campaign's gift(s) can be sent to (in `ISO 3166-1` alpha-2 format).
    </ResponseField>

    <ResponseField name="currency" type="string" required>
      The campaign's gift currency (in `ISO 4217` format).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "current_page": 1,
    "per_page": 1,
    "total_posts": 5,
    "touches": [
      {
        "id": 123456,
        "name": "Sendoso Gift",
        "start_date": "2023-10-25T00:00:00.000-07:00",
        "end_date": null,
        "description": "",
        "created_at": "2023-10-25T05:21:59.000-07:00",
        "user_id": 78901,
        "gift_id": 39,
        "starting_egift_price": null,
        "ending_egift_price": null,
        "status": "Active",
        "is_default_price": true,
        "delivery_type": "mail",
        "hubspot_key": null,
        "ship_to_countries": ["US", "ES", "CA"],
        "currency": "USD"
      }
    ]
  }
  ```
</ResponseExample>