# Tools API

Helpers for testing and integration: list seller IDs and score a phone number by whether it has carried traffic on the exchange.

## List seller routes

`POST https://apiv2.telecomsxchange.com/sellers/list`

Reference: https://help.telecomsxchange.com/reference/tools/#list-seller-routes

Lists the routes on the exchange that you can see: every public route plus the private routes a seller has opened to you, with the seller's login and `i_vendor`, the route's `i_connection` and `i_tariff`, and its type label. Use `i_connection` to buy a route and `i_tariff` to download its rate deck. Free.

> Send `pager` and `off` in the form body; they are ignored in the query string. `pager` is an end position: off=30 with pager=30 returns no routes.

### Parameters

| Name | Type | In | Required | Description |
|---|---|---|---|---|
| `off` | integer | body | no | Position of the first route to return, counting from 0. Default `0`. Example `0`. |
| `pager` | integer | body | no | Position at which to stop, exclusive. This is an end position, not a page size: to read routes 30 to 59, send off=30 and pager=60. Send a large value such as 10000 to get every route. Default `30`. Example `10000`. |

### Request

```bash
curl --digest -u "$TCXC_USERNAME:$TCXC_API_KEY" -X POST \
  "https://apiv2.telecomsxchange.com/sellers/list" \
  -d off=0 \
  -d pager=10000
```

### Response: Example

```json
{
  "status": "success",
  "routes": [
    {
      "seller_name": "NorthStarTel",
      "i_vendor": "112",
      "route_name": "UAE Premium",
      "i_connection": "128",
      "i_tariff": "129",
      "private": "0",
      "i_private_connection": null,
      "type": "NA"
    },
    {
      "seller_name": "NorthStarTel",
      "i_vendor": "112",
      "route_name": "Egypt CLI",
      "i_connection": "133",
      "i_tariff": "134",
      "private": "1",
      "i_private_connection": "57",
      "type": "NA"
    }
  ]
}
```