# Carriers

> The active carriers, their delivery method, delivery time and fee.

Source: https://docs.b7r.app/carriers

> Amounts, ids and limits in the examples are samples. Read the real values from the API.

## List carriers

`GET /v1/carriers`

Every carrier you can choose today. `delivery_method` is `home` (to the door) or `pickup` (to a pickup point); `eta_days` is the usual delivery time in days. The `fee` is per shipment, as net, VAT and gross; it does not depend on the address. Addresses arrive with orders, in a later version.

Your default carrier is `default_carrier` in [`GET /v1/me`](https://docs.b7r.app/keys-and-access#read-your-account-and-key). A quote without `carrier_id` uses it.

Key: A key with the `catalog` area.

Answer:

- `data` (array of object, required)
  - `id` (string (uuid), required)
  - `name` (object, required)
    - `ar` (string, required)
    - `en` (string, required)
  - `fee` (object, required)
    - `net` (string, required)
    - `vat` (string, required)
    - `gross` (string, required)
    - `currency` (constant, required): Always `"SAR"`.
  - `delivery_method` (string, required): One of `home`, `pickup`.
  - `eta_days` (object, required)
    - `min` (integer, required)
    - `max` (integer, required)

Errors: `unauthorized` (401), `area_forbidden` (403), `account_inactive` (403), `connection_disabled` (403), `invalid_request` (400), `rate_limited` (429), `internal_error` (500), `upstream_unavailable` (502), `api_unavailable` (503), `request_expired` (503), `service_unavailable` (503), `upstream_timeout` (504). See [Errors](https://docs.b7r.app/errors).

Request:

```bash
curl https://api.b7r.app/v1/carriers \
  -H "Authorization: Bearer $B7R_API_KEY"
```

```javascript
const res = await fetch("https://api.b7r.app/v1/carriers", {
  headers: {
    Authorization: `Bearer ${process.env.B7R_API_KEY}`,
  },
});
const data = await res.json();
```

```python
import os, requests

res = requests.get(
    "https://api.b7r.app/v1/carriers",
    headers={
        "Authorization": f"Bearer {os.environ['B7R_API_KEY']}",
    },
    timeout=30,
)
data = res.json()
```

Answer (200 OK):

```json
{
  "data": [
    {
      "id": "9b1d3f5a-7c9e-4b1d-8f5a-6c8e0a2b4d6f",
      "name": {
        "ar": "شحن سريع",
        "en": "Express delivery"
      },
      "fee": {
        "net": "25.00",
        "vat": "0.00",
        "gross": "25.00",
        "currency": "SAR"
      },
      "delivery_method": "home",
      "eta_days": {
        "min": 2,
        "max": 4
      }
    },
    {
      "id": "0c2e4a6b-8d0f-4c2e-9a6b-7d9f1b3c5e7a",
      "name": {
        "ar": "استلام من نقطة",
        "en": "Pickup point"
      },
      "fee": {
        "net": "18.00",
        "vat": "0.00",
        "gross": "18.00",
        "currency": "SAR"
      },
      "delivery_method": "pickup",
      "eta_days": {
        "min": 3,
        "max": 5
      }
    }
  ]
}
```
