Skip to content

Currency convert · POST Convert an amount to another currency

BeMap name: Currency convert · POST

POST/currency/1.0/convert

The same conversion, with the amount and the currencies sent in a JSON body.

The whole description

In BeMap's words

Convert a currency to another.

Convert a currency to another.

Requires the Currency option. Allow to get currency information. Not enabled on your account? Ask your BeNomad contact.

Request body

JSON, Content-Type: application/json. Schema CurrencyConvertRequest.

fromstringrequired
The currency to convert from
valuenumber (float)required
The amount to of the from currency to be converted
tostringrequired
The currency to convert from
geoserverstring
Geoserver name.
swidxinteger (int32)deprecated
Switch index.

Response

200, schema CurrencyConvertResponse.

Response fields

lastUpdateinteger (int64)
valuenumber (float)

Errors

400 Bad Request, ErrorResponse
302 No credentials were sent. Do not follow the redirect.
401 The account or the API key is wrong.

How to read each one: Errors.

Reference pages

Currency convert

Request

curl -X POST 'https://bemap.benomad.com/bgis/service/currency/1.0/convert' \
  -u 'YOUR_ACCOUNT:YOUR_API_KEY' \
  --fail-with-body \
  -H 'Content-Type: application/json' \
  -d '{
  "from": "USD",
  "to": "EUR",
  "value": 100
}'

const response = await fetch('https://bemap.benomad.com/bgis/service/currency/1.0/convert', {
  method: 'POST',
  headers: {
    Authorization: 'Basic ' + btoa('YOUR_ACCOUNT:YOUR_API_KEY'),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "from": "USD",
    "to": "EUR",
    "value": 100
  }),
  redirect: 'manual', // a missing credential answers 302: never follow it
});

if (response.type === 'opaqueredirect' || (response.status >= 300 && response.status < 400)) throw new Error('BeMap redirected to its login page: no credentials reached it');
if (!response.ok) throw new Error(`BeMap answered ${response.status}: ${await response.text()}`);
const data = await response.json();

import requests

response = requests.post(
    "https://bemap.benomad.com/bgis/service/currency/1.0/convert",
    auth=("YOUR_ACCOUNT", "YOUR_API_KEY"),
    json={
        "from": "USD",
        "to": "EUR",
        "value": 100,
    },
    allow_redirects=False,  # a missing credential answers 302: never follow it
)
if response.is_redirect:
    raise RuntimeError("BeMap redirected to its login page: no credentials reached it")
if response.status_code != 200:
    raise RuntimeError(f"BeMap answered {response.status_code}: {response.text}")
data = response.json()

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.util.Base64;

String auth = Base64.getEncoder().encodeToString("YOUR_ACCOUNT:YOUR_API_KEY".getBytes(StandardCharsets.UTF_8));
String body = """
    {
      "from": "USD",
      "to": "EUR",
      "value": 100
    }
    """;

HttpRequest request = HttpRequest.newBuilder(URI.create("https://bemap.benomad.com/bgis/service/currency/1.0/convert"))
    .header("Authorization", "Basic " + auth)
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString(body))
    .build();

// HttpClient never follows redirects by default: a 302 means a missing credential.
HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());
if (response.statusCode() / 100 == 3) throw new IllegalStateException("BeMap redirected to its login page: no credentials reached it");
if (response.statusCode() != 200) throw new IllegalStateException("BeMap answered " + response.statusCode() + ": " + response.body());
String json = response.body();

<?php
$body = <<<'JSON'
{
  "from": "USD",
  "to": "EUR",
  "value": 100
}
JSON;

$ch = curl_init('https://bemap.benomad.com/bgis/service/currency/1.0/convert');
curl_setopt_array($ch, [
    CURLOPT_USERPWD => 'YOUR_ACCOUNT:YOUR_API_KEY',
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_FOLLOWLOCATION => false, // a missing credential answers 302: never follow it
]);
$response = curl_exec($ch);
if ($response === false) throw new RuntimeException(curl_error($ch));
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($status >= 300 && $status < 400) throw new RuntimeException('BeMap redirected to its login page: no credentials reached it');
if ($status !== 200) throw new RuntimeException("BeMap answered $status: $response");

$data = json_decode($response, true);

using System.Net;
using System.Net.Http.Headers;
using System.Text;

// AllowAutoRedirect = false: a missing credential answers 302, never follow it.
var client = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });
var token = Convert.ToBase64String(Encoding.UTF8.GetBytes("YOUR_ACCOUNT:YOUR_API_KEY"));
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", token);

var body = """
    {
      "from": "USD",
      "to": "EUR",
      "value": 100
    }
    """;
var response = await client.SendAsync(new HttpRequestMessage(HttpMethod.Post, "https://bemap.benomad.com/bgis/service/currency/1.0/convert")
{
    Content = new StringContent(body, Encoding.UTF8, "application/json"),
});
if ((int)response.StatusCode / 100 == 3) throw new HttpRequestException("BeMap redirected to its login page: no credentials reached it");
if (response.StatusCode != HttpStatusCode.OK) throw new HttpRequestException($"BeMap answered {(int)response.StatusCode}: {await response.Content.ReadAsStringAsync()}");
var json = await response.Content.ReadAsStringAsync();

Response · 200

{
  "lastUpdate": 1790905053001,
  "value": 85.31106
}

Captured from production.

Build with AI

Write the code that calls the BeMap API operation "Currency convert · POST": POST https://bemap.benomad.com/bgis/service/currency/1.0/convert

- Authenticate with HTTP Basic: the BeMap account as the user name, the API key as the password. Do not follow redirects: a 302 means the credentials were not sent.
- Send JSON (Content-Type: application/json) of type `CurrencyConvertRequest`; it requires `from`, `to`, `value`.
- Use only the fields the reference lists: BeMap ignores an unknown field name without an error, so a misspelt field configures nothing.
- A 400 with "Access Denied" means the account lacks the Currency option; a 401, a wrong account or key.

Reference, with every field and what each value means: https://benomad.com/dev/doc/bemap-api/api/map-context/currency-convert-post.md

With the BeMap MCP server, your assistant also checks each request against the specification before sending it.

Try it