---
title: "The directory of presence providers a policy may name"
method: GET
path: "/v1/presence-providers"
---

# The directory of presence providers a policy may name

`GET /v1/presence-providers`

## Request

- Base URL: `https://api.decionis.com`
- URL: `https://api.decionis.com/v1/presence-providers`
- Auth: HTTP bearer

Third parties that prove a person was present for an intent, such as a card issuer's partner proving the cardholder tapped their own card (method CARD_TAP). Decionis operates the directory; each entry names the provider's attestation `iss` and the JWKS it publishes its Ed25519 keys at. An organisation trusts a provider only once it admits it (PUT /v1/execution/presence-providers/{provider_id}/admission). Requires policy:read, policy:write or org:* scope.

## Response `200`

Active directory entries

- PresenceProviderDirectory
  - `service` 'decionis', required
  - `providers` PresenceProviderDirectoryEntry[], required
    - `service` 'decionis', required
    - `provider_id` string, required: The id a policy names in verification_requirements.provider.
    - `display_name` string, required
    - `issuer` string, required: The `iss` the provider writes into its attestations.
    - `jwks_url` string, uri, required: Where the provider publishes its Ed25519 public keys; https only.
    - `methods` string[], required
    - `revoked_at` string, date-time, nullable, required

## Other responses

- `401`: Structured API error
- `403`: Structured API error

---

[API](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api.md) · [All operations](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/revisions/357f5e459d0c?raw)