Get subscription and usage statistics

GET

https://api.nownodes.io/v1.0/subscription

Authorizations

ApiKeyAuthApiKeyAuth

token string

NOWNodes API key passed in the api-key header.

Returns subscription details and request usage statistics for the provided token (available from Business plan).

Response

200OK

Successful response with subscription and usage statistics.

401Unauthorized

Invalid or missing token.

403Forbidden

Token does not have access to this endpoint.

500Internal Server Error

Internal server error.

Get subscription and usage statistics

curl -X GET 'https://api.nownodes.io/v1.0/subscription'

const response = await fetch('https://api.nownodes.io/v1.0/subscription', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://api.nownodes.io/v1.0/subscription')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://api.nownodes.io/v1.0/subscription')
data = response.json()

const response = await fetch('https://api.nownodes.io/v1.0/subscription', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://api.nownodes.io/v1.0/subscription";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://api.nownodes.io/v1.0/subscription', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://api.nownodes.io/v1.0/subscription')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://api.nownodes.io/v1.0/subscription')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

{
  "subscription_type": "business",
  "activated_at": "2026-06-08T09:56:00.000Z",
  "expires_at": "2026-07-08T09:56:38.745Z",
  "used_requests_per_month": 203643,
  "overage_requests_per_month": 0,
  "request_limit_per_month": 30000000,
  "remaining_requests_per_month": 29796357,
  "usage_percent_per_month": 1
}

{
  "message": "Invalid or missing token",
  "error": "Unauthorized",
  "statusCode": 401
}

{
  "message": "This token does not have access to the endpoint",
  "error": "Forbidden",
  "statusCode": 403
}

{
  "statusCode": 500,
  "message": "Internal server error"
}