> ## 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.

# Retrieve All Sends

> Retrieves a list of all sends initiated by anyone in 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 sends to be returned per page (max is 100). See [Pagination](https://developer.sendoso.com/rest-api/overview/pagination) for more information.
</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_count" type="integer" required>
  The total number of sends (used for pagination purposes).
</ResponseField>

<ResponseField name="sends" type="array" required>
  List of sends

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

    <ResponseField name="send_gid" type="string" required>
      The gid of the send.
    </ResponseField>

    <ResponseField name="type" type="string" required>
      The send's type. Possible values are `Amazon`, `Handwritten Notes`, `Inventoried Sends`, `Sendoso Choice`, `Sendoso Direct`, `eGifts International`, `eGifts USA`
    </ResponseField>

    <ResponseField name="subtype" type="string" required>
      The send's subtype. Possible values are `Bundles`, `Buy/Send via Amazon`, `Buy/Send via Amazon UK`, `Coffee`, `Custom`, `Custom Bundles`, `DDO_GIFT`, `Donate to Charity`, `Experiences`, `Handwritten Notes`, `Lunch`, `On-Demand`, `Visa eGift Credit Card (US)`, `Wine`, `eGift Cards Australia`, `eGift Cards Brazil`, `eGift Cards Canada`, `eGift Cards France`, `eGift Cards Germany`, `eGift Cards India`, `eGift Cards Ireland`, `eGift Cards Italy`, `eGift Cards Mexico`, `eGift Cards Netherlands`, `eGift Cards New Zealand`, `eGift Cards Poland`, `eGift Cards Singapore`, `eGift Cards Slovakia`, `eGift Cards UK`, `eGift Cards USA`
    </ResponseField>

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

    <ResponseField name="current_total_cost" type="string" required>
      The send's cost at the time that this request was made. Note that this cost could change overtime until the send is in a final status.
    </ResponseField>

    <ResponseField name="status" type="string" required>
      The current send's status. Possible values are `Address Confirmation - Cancelled`, `Bounced and Credited`, `Cancelled`, `Clicked`, `Collecting recipient info`, `Confirming Address`, `Delivered`, `Expired and Credited`, `Failed`, `Opened`, `Packed`, `Paused`, `Processing`, `Refunded`, `Sent`, `Shipped`, `Undeliverable`, `Used`, `pending`.
    </ResponseField>

    <ResponseField name="created_at" type="string" required>
      The date and time the send was initiated (in `ISO 8601` format).
    </ResponseField>

    <ResponseField name="touch" type="object" required>
      The campaign from which this send was initiated.

      <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>
      </Expandable>
    </ResponseField>

    <ResponseField name="recipient" type="object" required>
      The recipient that the gifts were sent to.

      <Expandable title="recipient" defaultOpen="true">
        <ResponseField name="name" type="integer" required>
          The recipient's name.
        </ResponseField>

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

        <ResponseField name="company_name" type="string" required>
          The recipient's company name.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="sender" type="object" required>
      The user that initiated the send.

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

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

        <ResponseField name="email" type="string" required>
          The sender's email address.
        </ResponseField>

        <ResponseField name="team_id" type="integer" required>
          The sender's team identifier.
        </ResponseField>

        <ResponseField name="team_name" type="string" required>
          The sender's team name.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="sent_via" type="string" required>
      Platform where the sent was initiated from.
    </ResponseField>

    <ResponseField name="status_updates" type="array" required>
      List of the different send status changes and when they occurred.

      <Expandable title="status_updates" defaultOpen="true">
        <ResponseField name="status" type="integer" required>
          The status that the send changed to
        </ResponseField>

        <ResponseField name="occurred_at" type="string" required>
          The date and time when the status change occurred (in `ISO 4217` format).
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "current_page": 1,
    "per_page": 10,
    "total_count": 892,
    "sends": [
      {
        "id": 1,
        "send_gid": "Z2lkOi8vc2VuZG9zby9TZW5kLzQ0",
        "type": "eGifts USA",
        "subtype": "eGift Cards USA",
        "currency": "USD",
        "current_total_cost": "2.0",
        "status": "Expired",
        "created_at": "2022-09-12T12:08:27-07:00",
        "touch": {
          "id": 12,
          "name": "eGift Cards USA"
        },
        "recipient": {
          "name": "John Doe",
          "email": "johndoe@acme.com",
          "company_name": "Acme"
        },
        "sender": {
          "id": 123,
          "name": "Marc Fernandez",
          "email": "marc.fernandez@sendoso.com",
          "team_id": 123,
          "team_name": "Marketing Ops"
        },
        "sent_via": "Sendoso.com",
        "status_updates": [
          {
            "status": "Sent",
            "occurred_at": "2022-09-12T12:08:27-07:00"
          },
          {
            "status": "Opened",
            "occurred_at": "2022-09-12T12:08:58-07:00"
          },
          {
            "status": "Clicked",
            "occurred_at": "2022-09-12T12:08:58-07:00"
          },
          {
            "status": "Expired",
            "occurred_at": "2022-12-11T00:00:02-08:00"
          }
        ]
      },
      {
        "id": 2,
        "send_gid": "Z2lkOi8vc2VuZG9zby9TZW5kLzE",
        "type": "Inventoried Sends",
        "subtype": "Custom",
        "currency": "USD",
        "current_total_cost": "5.0",
        "status": "Address Confirmation - Cancelled",
        "created_at": "2022-12-21T23:37:22-08:00",
        "touch": {
          "id": 25,
          "name": "Triggered inventory"
        },
        "recipient": {
          "name": "Marc Fernandez Girones",
          "email": "marc.fernandez@sendoso.com",
          "company_name": "Sendoso"
        },
        "sender": {
          "id": 123,
          "name": "Marc Fernandez",
          "email": "marc.fernandez@sendoso.com",
          "team_id": 123,
          "team_name": "Marketing Ops"
        },
        "sent_via": "Salesforce Trigger",
        "status_updates": [
          {
            "status": "Confirming Address",
            "occurred_at": "2022-12-22T05:42:27-08:00"
          },
          {
            "status": "Address Confirmation - Cancelled",
            "occurred_at": "2022-12-27T09:00:05-08:00"
          }
        ]
      }
    ]
  }
  ```
</ResponseExample>