---
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.

## Changes

- **2026-06-12** `54cf11f8a76f` — 1 info
  - added the required property `data/subscribed` to the response with the `200` status
- **2026-05-01** `c8fedcbd705e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/postgrid/apis/postgrid-address-verification-api/changes/v1/addver/get.md)

---

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