GET Source Details

Fetch one connected identity source, including how many identities depend on it

GEThttps://api.anakin.io/v1/wire/identity-sources/{id}

Returns a single connected source. Unlike the list endpoint, this one also carries identities_using — how many identities would be affected if you disconnected it. That count is the thing worth checking before a disconnect.

The encrypted credential is never returned. Requires an X-API-Key; the source must belong to the authenticated user.


Path Parameters

ParameterTypeDescription
id requiredstring (UUID)Identity source ID

Response

200 OK
{
  "status": "ok",
  "identity_source": {
    "id": "f1e2d3c4-0000-0000-0000-000000000000",
    "user_id": "8a7b6c5d-0000-0000-0000-000000000000",
    "provider": "1password",
    "display_name": "Engineering vault",
    "config": { "auth_method": "service_account" },
    "scope_metadata": { "vaults": [ { "id": "abcd1234", "name": "Engineering" } ] },
    "status": "active",
    "last_verified_at": "2026-06-08T10:00:00Z",
    "created_at": "2026-06-01T09:00:00Z",
    "updated_at": "2026-06-08T10:00:00Z"
  },
  "identities_using": 3
}
FieldTypeDescription
identity_sourceobjectSame shape as an element of GET /v1/wire/identity-sources
identity_source.config.auth_methodstringWhich auth method the source was connected with — present only if auth_method was sent at connect time, otherwise config is {}. A rotation reuses it when present, and falls back to the provider's default when not
identities_usingnumberIdentities whose credentials come from this source. Use GET /v1/wire/identity-sources/{id}/identities for the list itself

identities_using is omitted — not zeroed — when the count can't be taken. The source is still returned, so treat an absent key as unknown and a 0 as counted, and nothing depends on it. The distinction matters before a cascading disconnect: "unknown" read as "zero" is how you delete identities you were told didn't exist.

The list endpoint deliberately omits this count: computing it per row would be an N+1 query.


Error Responses

CodeHTTPWhen
NOT_FOUND404No source with that ID
FORBIDDEN403The source belongs to another user

Code Examples

curl https://api.anakin.io/v1/wire/identity-sources/f1e2d3c4-0000-0000-0000-000000000000 \
  -H "X-API-Key: your_api_key"

Rate limit

60 requests per minute per user.