Check Remaining Credits - SignalHire API

Credits can be checked at any time using a dedicated endpoint, or by inspecting the X-Credits-Left header included in every API response. Endpoint: GET https://www.signalhire.com/api/v1/credits

Standard Credits

Returns the remaining balance of standard credits used by the Person API (with contacts).

curl -X GET \
-H 'apikey: your_secret_api_key' \
https://www.signalhire.com/api/v1/credits

import requests

response = requests.get(
"https://www.signalhire.com/api/v1/credits",
headers={"apikey": "your_secret_api_key"}
)

const axios = require('axios');

const response = await axios.get(
'https://www.signalhire.com/api/v1/credits',
{
    headers: { apikey: 'your_secret_api_key' }
}
);

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://www.signalhire.com/api/v1/credits"))
.header("apikey", "your_secret_api_key")
.GET()
.build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

require 'net/http'

uri = URI('https://www.signalhire.com/api/v1/credits')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['apikey'] = 'your_secret_api_key'

response = http.request(request)

Response (HTTP 200):

HTTP/2 200
Content-Type: application/json
X-Credits-Left: 27

{
"credits": 27
}

Without Contacts Credits

To check the remaining balance of without-contacts credits, add the withoutContacts=true query parameter. See Profiles Without Contacts for details on this credit type.

curl -X GET \
-H 'apikey: your_secret_api_key' \
'https://www.signalhire.com/api/v1/credits?withoutContacts=true'

import requests

response = requests.get(
"https://www.signalhire.com/api/v1/credits",
headers={"apikey": "your_secret_api_key"},
params={"withoutContacts": "true"}
)

const axios = require('axios');

const response = await axios.get(
'https://www.signalhire.com/api/v1/credits',
{
    headers: { apikey: 'your_secret_api_key' },
    params: { withoutContacts: true }
}
);

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://www.signalhire.com/api/v1/credits?withoutContacts=true"))
.header("apikey", "your_secret_api_key")
.GET()
.build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

require 'net/http'

uri = URI('https://www.signalhire.com/api/v1/credits?withoutContacts=true')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['apikey'] = 'your_secret_api_key'

response = http.request(request)

X-Credits-Left Header

Every API response includes the X-Credits-Left header with the current credit balance. The value automatically reflects the credit type matching the request — without-contacts credits when withoutContacts: true is set, standard credits otherwise.