## API-URL
URL for sending av HTTP-forespørsler:
```url
https://portal.bulkgate.com/api/1.0/price-list/get
```

> [!NOTE]
> Hvis forespørselen ikke når frem, gjentar du den på [reserveserveren](https://www.bulkgate.com/no/dokumentasjon/api-administrasjon/api-reserveserver/) `backup1.bulkgate.com`.


```http
POST /api/1.0/price-list/get HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json
```

> [!NOTE]
> API-et er begrenset av en minuttkvote på **20** forespørsler.

### Parametertabell

| PARAMETERNAVN     | VERDI | OBLIGATORISK | STANDARDVERDI |
|:------------------|:------|:----------|:--------------|
| application_id    | [Applikasjons-ID](https://www.bulkgate.com/no/dokumentasjon/api-administrasjon/administrasjon-av-api/) | **Ja** | - | 
| application_token | [Applikasjonstoken](https://www.bulkgate.com/no/dokumentasjon/api-administrasjon/api-token/) | **Ja** | - |
| country           | Matrise med landskodene for de ønskede prislistene | **Ja** | - |
| wallet            | Navnet på lommeboken du foretrekker. | Nei | Hovedlommebok |


> I motsetning til de andre endepunktene avviser `price-list/get` alle parametere som ikke står i tabellen ovenfor, med `invalid_input_parameters`. `country` må alltid være en matrise, også for ett enkelt land.

### Eksempel på fullstendig forespørsel

```http-json
POST /api/1.0/price-list/get HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json

{
	"application_id": 451,
	"application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj",
	"country": ["sk", "cz"],
	"wallet": "bg1905014138000023"
}
```

## Svaret på denne kommandoen kan være:

**Ved suksess:**
```json
{
  "data": {
    "price_list": {
      "sk": [
        {
          "operator": "4ka",
          "operator_code": "23103",
          "type": "gSystem",
          "price": 0.03,
          "currency": "EUR",
          "gate": 0,
          "economy": false,
          "unicode": true,
          "two_way": true,
          "registration": false,
          "registration_fee": 0,
          "registration_delay": 0,
          "monthly_fee": 0,
          "route_quality": "HQ",
          "route_note": null,
          "sender_note": null,
          "default_senders": [
            "+##############"
          ]
        },
        {
          "operator": "O2",
          "operator_code": "23106",
          "type": "gSystem",
          "price": 0.03,
          "currency": "EUR",
          "gate": 0,
          "economy": false,
          "unicode": true,
          "two_way": true,
          "registration": false,
          "registration_fee": 0,
          "registration_delay": 0,
          "monthly_fee": 0,
          "route_quality": "HQ",
          "route_note": null,
          "sender_note": null,
          "default_senders": [
            "+###############"
          ]
        }
      ]
    }
  }
}
```



### Element i prislisten

`data.price_list` er et objekt med landskoden som nøkkel; under hver nøkkel ligger en matrise med ruter. Et land som ikke har noen prisliste, er **ikke** med i svaret i det hele tatt.

| FELT               | VERDI                                                                                                                                                         |
|:-------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------|
| operator           | Operatørens navn |
| operator_code      | Operatørkode |
| type               | Avsendertypen for ruten: `gTextOwn`, `gSystem`, `gShort`, `gText`, `gOwn`, `gMobile`, `gPush`, eller `gNone` når ruten ikke har noen |
| price              | Pris for én meldingsdel, avrundet til 4 desimaler og omregnet til lommebokens valuta |
| currency           | Valutaen til lommeboken prislisten tilhører |
| gate               | Gatewaynummer `0`–`6`, `985` for [Mobile Connect](https://www.bulkgate.com/no/hjelpesenter/mobile-connect/mobile-connect-installasjon/) |
| economy            | Økonomirute |
| unicode            | Ruten støtter Unicode |
| two_way            | Ruten støtter [toveiskommunikasjon](https://www.bulkgate.com/no/produkter/toveis-sms/). Alltid `true` for `gOwn` |
| registration       | Avsender-ID-en må registreres før sending, se [Registrering av tekstavsender](https://www.bulkgate.com/no/hjelpesenter/sms/slik-registrerer-du-en-tekstavsender/) |
| registration_fee   | Engangsavgift for registrering av avsender-ID-en. Har bare betydning sammen med `registration` |
| registration_delay | Hvor lang tid registreringen tar. Har bare betydning sammen med `registration` |
| monthly_fee        | Fast månedsavgift for den registrerte avsender-ID-en. Har bare betydning sammen med `registration` |
| route_quality      | En av `HQ`, `PARTNER DIRECT`, `DIRECT`, `SIM`, `WH`, `SS7`, `PARTNER SS7`, `OFFNET DIRECT - NATIONAL`, `OFFNET DIRECT - GROUP`, `OFFNET DIRECT - INTERNATIONAL` og deres `PARTNER`-varianter. En **tom streng** når kvaliteten ikke er kjent |
| route_note         | Merknad om ruten, `null` når det ikke finnes noen |
| sender_note        | Merknad om avsender-ID-en, `null` når det ikke finnes noen |
| default_senders    | Matrise med rutens standard avsender-ID-er |


**Ved feil:**

```json
{
    "type": "invalid_wallet",
    "code": 400,
    "error": "Invalid wallet",
    "detail": null
}
```

```json
{
    "type": "the_quota_of_send_per_minute_has_been_exceeded",
    "code": 400,
    "error": "The quota of send per minute has been exceeded",
    "detail": null
}
```

```json
{
    "type": "invalid_input_parameters",
    "code": 400,
    "error": "Invalid input parameters",
    "detail": null
}
```

```json
{
    "type": "unknown_identity",
    "code": 401,
    "error": "Unknown identity / unauthorized / empty application_id",
    "detail": null
}
```

Der:
 - **type** og **error** (beskrivelse av feilen) finner du i [tabellen over feiltyper](https://www.bulkgate.com/no/dokumentasjon/api-administrasjon/api-feiltyper/)
 - **code** er HTTP-feilkoden
 - **detail** er tilleggsinformasjon om feilen