Skip to content
Venue AuthorityTry the API

Developer API

Resolve the regulator record or get a plain rejection.

The authenticated endpoint matches a merchant name and address against 47,543 current representative records. Weak names, address conflicts, and material ties stay rejected.

Authenticated test key

The public demo is available without an account. Sign in to receive a limited server-issued test key that can be revoked and shown once.

The server shows the plaintext once and stores only a digest. Test access receives 25 units; live keys use prepaid capacity.

Try the public deep-history demo

This form uses the separate 100-facility evidence dataset and does not consume prepaid units.

Try:

Authenticated request

curl 'https://venueauthority.com/api/v1/resolve' \
  --request POST \
  --header 'Authorization: Bearer va_test_REPLACE_ME' \
  --header 'Content-Type: application/json' \
  --header 'X-Request-Id: onboarding-merchant-0001' \
  --data '{"name":"YOAN MING GARDEN","address":"1407 Madison Avenue, New York NY 10029"}'

Accepted response

{
  "disposition": "accepted",
  "reason": "The name and address clear the corpus resolution policy.",
  "confidence": 1,
  "record": {
    "jurisdiction": "nyc",
    "sourceId": "50069801",
    "name": "YOAN MING GARDEN",
    "sourceUrl": "https://data.cityofnewyork.us/..."
  },
  "dataClass": "identity_resolution_corpus",
  "requestId": "onboarding-merchant-0001"
}

Authenticated contract

Disposition

Accepted or rejected. Rejections include the policy reason and up to three candidates.

Idempotency

Reuse the same route and request ID to receive the durable result without a second debit.

Data class

Every response identifies the resolver corpus, snapshot time, record count, and manifest hash.

Canonical identity

Accepted results return a jurisdiction, regulator source ID, normalized address, and source URL.

Keep the two datasets separate

The authenticated resolver does not certify operating authority or provide complete event history. The public 100-facility demo contains deeper retained events. A demo evidence receipt must not be generalized to the full resolver corpus.

Run a real authenticated test

Create a workspace to receive 25 test units once. Plaintext keys are shown once, stored only as a digest, and can be revoked from the dashboard.

Create a workspace