# List pricing plans

> What each product costs your business, before you vend it.

Source: https://useroutegate.com/docs/api/public/getPublicPricingPlans

`GET /api/v1/pricing/plans`

Filter by `network` and `service` codes, or by their ids. A variable amount product is priced at its minimum amount. `price_kobo` is what the wallet is charged and `charge_kobo` the part of it above face value.

Authenticate with a bearer API key: `rg_test_` in test mode, `rg_live_` in live.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `network` | query | string | no | A network code from [List networks](/docs/api/public/listNetworks). |
| `service` | query | string | no | A service code from [List services](/docs/api/public/listServices). |
| `network_id` | query | string (uuid) | no | A network's id, instead of its code. |
| `service_id` | query | string (uuid) | no | A service's id, instead of its code. |

## Request

```bash
curl -X GET "https://api.useroutegate.com/api/v1/pricing/plans?network=mtn&service=airtime" \
  -H "Authorization: Bearer $ROUTEGATE_API_KEY"
```

## Response

`200`

```json
{
  "success": true,
  "code": "OK",
  "message": "OK",
  "data": {
    "items": [
      {
        "id": "00000000-0000-7000-8000-000000001301",
        "networkid": "00000000-0000-7000-8000-000000000101",
        "network_id": "00000000-0000-7000-8000-000000000101",
        "serviceid": "00000000-0000-7000-8000-000000000201",
        "service_id": "00000000-0000-7000-8000-000000000201",
        "plan_name": "MTN Airtime",
        "amount": 5000,
        "amount_kobo": 5000,
        "charge": 0,
        "charge_kobo": 0,
        "fee": 0,
        "fee_kobo": 0,
        "price": 5000,
        "price_kobo": 5000,
        "product_code": "MTN-VTU",
        "network": "mtn",
        "service": "airtime"
      }
    ]
  }
}
```

## Error

`401` `AUTH_REQUIRED`: The key is missing, unknown, revoked or expired. Every code is in [errors](/docs/concepts/errors).

```json
{
  "success": false,
  "data": null,
  "message": "Invalid API key",
  "code": "AUTH_REQUIRED"
}
```

## Give this to your coding agent

Read `https://useroutegate.com/docs/api/public/getPublicPricingPlans.md` and implement this call. Amounts are integers in kobo.
