aVenture APIIdentifiers

Deprecated: look up an identifier owner

Deprecated
View as Markdown

Deprecated: use lookup unique-ids (GET /v1/lookup/unique-ids). Resolves an external identifier to its owner(s). idType accepts a canonical token or alias; the value is normalized per type before matching. Returns every owner that carries the identifier (a value can recur across owners, e.g. a reused ticker), each row carrying its entityId or personId.

Authentication

AuthorizationBearer

User bearer token: Clerk session JWT, Clerk OAuth access token, or Clerk API key

Query parameters

idTypestringRequired
Identifier type token or alias, for example ein.
identifierstringRequired
Identifier value to resolve.

Response headers

X-RateLimit-Limitinteger

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-Remaininginteger

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-Resetinteger

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

Response

OK
createdAtdatetime
Row creation timestamp.
idinteger

Unique-id row id.

idTypeenum
Identifier type.
identifierstring

Identifier value as issued by the registry (normalized per type).

ownerobject

Owning entity or person id; exactly one nested id is present.

updatedAtdatetime
Row update timestamp.
sourcestring or nullOptional
Attribution source label for the mapping, when recorded.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
406
Not Acceptable Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error