Svit.One Docs
Reference

Look up a Person by an exact external identity

Requires the same Integration-level token allowlist as associated creation. Returns only the current active Person ID for this exact source key, not an original response replay or source observation. No identity is claimed or refreshed. Unknown, retired, archived, deleted and Organization-owned keys return the same 404.

GET/v1/external/people/by-external-id

Requires the same Integration-level token allowlist as associated creation. Returns only the current active Person ID for this exact source key, not an original response replay or source observation. No identity is claimed or refreshed. Unknown, retired, archived, deleted and Organization-owned keys return the same 404.

Authorization

projectAccessToken
AuthorizationBearer <token>

Server-to-server Project Access Token. Requests operate in the token's Project.

In: header

Query Parameters

integrationId*string
Formatuuid
externalId*string
Length1 <= length <= 255

Response Body

application/json

curl -X GET "https://api-external.svit.one/api/v1/external/people/by-external-id?integrationId=497f6eca-6276-4993-bfeb-53cbbbba6f08&externalId=string"
{
  "personId": "string"
}
{
  "type": "https://api-errors.svit.one/validation/bad-request",
  "title": "Bad Request",
  "status": 400,
  "detail": "Invalid query or rejected project token",
  "code": "BAD_REQUEST",
  "timestamp": "2026-10-27T09:18:23.000Z"
}
{
  "type": "https://api-errors.svit.one/access/forbidden",
  "title": "Forbidden",
  "status": 403,
  "detail": "Association permission denied",
  "code": "FORBIDDEN",
  "timestamp": "2026-10-27T09:18:23.001Z"
}
Empty
{
  "type": "https://api-errors.svit.one/conflict/resource",
  "title": "Conflict",
  "status": 409,
  "detail": "Invalid Integration association configuration",
  "code": "CONFLICT",
  "timestamp": "2026-10-27T09:18:23.001Z"
}
{
  "type": "https://api-errors.svit.one/internal/server-error",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "Association lookup could not be completed",
  "code": "INTERNAL_SERVER_ERROR",
  "timestamp": "2026-10-27T09:18:23.001Z"
}
{
  "type": "https://api-errors.svit.one/internal/service-unavailable",
  "title": "Service Unavailable",
  "status": 503,
  "detail": "Concurrent change; retry with the same key",
  "code": "SERVICE_UNAVAILABLE",
  "timestamp": "2026-10-27T09:18:23.001Z"
}

External data ingestion POST

Processes a data ingestion job for the given `integrationId`. The request body is forwarded as raw JSON and processed asynchronously. Server token is required (project access token in the `Authorization` header).

Read an exact Person GET

Reads a Person only within the server token's Project. Archived People remain readable; deleted, missing, foreign-Project and Organization identifiers return non-disclosing 404s.