Get account UK VRM allowance and credits
One shared account balance covers every widget, REST API key and MCP client. Included allowance resets at the monthly UTC subscription anniversary; purchased credits never expire. Requires vdb_read, an active API or MAX full API subscription and UK VRM entitlement. Trial API access never grants access to this endpoint. Published allowance revisions apply immediately at their effective date, including during an existing period. The current plan determines the included limit; used and reserved lookups and purchased credits are preserved. A limit below existing consumption leaves zero included lookups remaining. Purchased units remain after cancellation and can be used through widgets on Free, with no included allowance. REST and MCP still require active API or MAX full API access. Retail purchase prices are published independently of provider contract costs.
curl --request GET \
--url https://api.remapdb.com/v2/vrm/uk/usage \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.remapdb.com/v2/vrm/uk/usage"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.remapdb.com/v2/vrm/uk/usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.remapdb.com/v2/vrm/uk/usage",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.remapdb.com/v2/vrm/uk/usage"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.remapdb.com/v2/vrm/uk/usage")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.remapdb.com/v2/vrm/uk/usage")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"included_limit": 600,
"included_used": 6,
"included_reserved": 0,
"included_remaining": 594,
"credit_balance": 100,
"credit_reserved": 0,
"credits_available": 100,
"resets_at": "2026-11-08T11:53:00Z"
}{
"error": {
"code": 404,
"message": "Not found"
}
}{
"error": {
"code": 404,
"message": "Not found"
}
}{
"error": {
"code": 404,
"message": "Not found"
}
}{
"error": {
"code": 404,
"message": "Not found"
}
}Authorizations
Response
Current allowance, reservations, credit balance and next reset.
curl --request GET \
--url https://api.remapdb.com/v2/vrm/uk/usage \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.remapdb.com/v2/vrm/uk/usage"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.remapdb.com/v2/vrm/uk/usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.remapdb.com/v2/vrm/uk/usage",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.remapdb.com/v2/vrm/uk/usage"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.remapdb.com/v2/vrm/uk/usage")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.remapdb.com/v2/vrm/uk/usage")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"included_limit": 600,
"included_used": 6,
"included_reserved": 0,
"included_remaining": 594,
"credit_balance": 100,
"credit_reserved": 0,
"credits_available": 100,
"resets_at": "2026-11-08T11:53:00Z"
}{
"error": {
"code": 404,
"message": "Not found"
}
}{
"error": {
"code": 404,
"message": "Not found"
}
}{
"error": {
"code": 404,
"message": "Not found"
}
}{
"error": {
"code": 404,
"message": "Not found"
}
}