# Get packages

`GET /v2/packages`

**Base URLs:**

- Sandbox: `https://api.sandbox.bobgo.co.za`
- Production: `https://api.bobgo.co.za`

**Authentication:** Bearer token required (see the Authentication page).

## Example request

```bash
curl -X GET 'https://api.sandbox.bobgo.co.za/v2/packages' \
  -H "Authorization: Bearer <API_KEY>"
```

Lists the packages on your account, the default package first and then by name.

| Name | Type | Notes |
| --- | --- | --- |
| `id` | integer | Fetch one package. |
| `limit` | integer | Page size. There is no default and no cap: leave it out and every package comes back. |
| `offset`, `order`, `order_by` | | Standard [pagination](../1_Introduction/README.md#listing-and-pagination). |

## Response

```json
{
  "packages": [
    {
      "id": 2241,
      "account_id": 1234,
      "name": "Standard sleeve",
      "is_default": true,
      "length_cm": 42,
      "width_cm": 38,
      "height_cm": 5
    },
    {
      "id": 2242,
      "account_id": 1234,
      "name": "Box",
      "is_default": false,
      "length_cm": 42,
      "width_cm": 38,
      "height_cm": 5
    }
  ],
  "count": 2
}
```

`count` is every package that matches, not the size of the page.
