---
title: "Get Bulk Lookup Credit balance"
method: GET
path: "/v1/tech-lookup/credits"
tags: ["TechLookup"]
---

# Get Bulk Lookup Credit balance

`GET /v1/tech-lookup/credits`

## Request

- Base URL: `https://api.stackscan.com/api`
- URL: `https://api.stackscan.com/api/v1/tech-lookup/credits`
- Auth: HTTP bearer and API key in header `X-Tenant-Id`

Returns your current Bulk Lookup Credit balance, the cost per successful
request, and how many credits you've used this month. Call this before a
batch of lookups if you want to avoid a 402 response. Checking your
balance does not consume a credit.

Rate limit: 500 requests per minute, counted per API token. Going over returns 429 with `error_code: rate_limited` and a `Retry-After` header in seconds. A 429 costs no credits. Traffic is also subject to a higher shared ceiling per network address, applied before authentication.

## Response `200`

Bulk Lookup Credits balance for the authenticated user.

- object
  - `success` boolean, required
  - `credit_type` string, required
  - `balance` number, required
  - `cost_per_successful_request` number, required
  - `monthly` object, required
    - `available` number, required
    - `used` number, required
    - `remaining` number, required

## Other responses

- `401`: Unauthenticated
- `429`: Rate limit exceeded. Costs no credits. Back off for the number of seconds in Retry-After.

---

[API](https://skmtc.dev/stackscan/apis/stackscan-api-reference.md) · [All operations](https://skmtc.dev/stackscan/apis/stackscan-api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/stackscan/apis/stackscan-api-reference/revisions/66531cd65f3a?raw)