Get One Person Identifier

GET

https://api.aventure.vc/v1/people/:personId/unique-ids/:uniqueIdId

Returns one external identifier mapping after verifying it belongs to the path owner.

Authentication

AuthorizationBearer

Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token

Path parameters

personIdstringRequiredformat: "uuid"

Canonical person UUID.

uniqueIdIdintegerRequired

Unique-id row id.

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

createdAtdatetime

Row creation timestamp.

idinteger

Unique-id row id.

idTypestring

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

404

Not Found Error

406

Not Acceptable Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error