---
title: "GET /v1/addver/"
method: GET
path: "/v1/addver/"
tags: ["Standard API"]
---

# GET /v1/addver/

`GET /v1/addver/`

Returns your organization's current lookup usage and plan information.
Useful for checking how many lookups you have consumed and whether you
are on a paid plan. If you are not subscribed, any lookup past your free
limit will fail — use this endpoint to check your remaining lookups.

## Response `200`

The request has succeeded.

- object
  - `status` 'success' | 'error', required
  - `message` string, required
  - `data` object, required
    - `used` integer, required — The number of lookups consumed in the current billing period.
    - `freeLimit` integer, nullable, required — The maximum number of lookups allowed in the current billing period. `null` indicates an unlimited plan.
    - `subscribed` boolean, required — Whether the organization is on a paid (subscribed) plan.

## Other responses

- `400` — The server could not understand the request due to invalid syntax.

---

[API](https://skmtc.net/postgrid/apis/postgrid-address-verification-api.md) · [All operations](https://skmtc.net/postgrid/apis/postgrid-address-verification-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/postgrid/postgrid-address-verification-api/versions/537d2bbc624a/schema)