---
title: "Get Credentials"
method: GET
path: "/v2/identities/{identifier}/credentials"
tags: ["Credentials"]
---

# Get Credentials

`GET /v2/identities/{identifier}/credentials`

## Request

- The document declares no server URL.
- Auth: HTTP basic

Returns a list of credentials for the provided identity. Results are paginated.
Filter between all | revoked | expired credentials and also perform a full text search with the query parameter.

## Path parameters

- `identifier` string, required

## Query parameters

- `page` integer
- `credentialSubject` string
- `schemaType` string
- `schemaUrl` string
- `status` 'all' | 'revoked' | 'expired'
- `query` string
- `max_results` integer
- `sort` string[]: The minus sign (-) before createdAt means descending order.

## Response `200`

List of credentials

- CredentialsPaginated
  - `items` Credential[], required
    - `id` string, required
    - `proofTypes` string[], required
    - `revoked` boolean, required
    - `schemaHash` string, required
    - `vc` object
    - `encryptedVC` EncryptedVC
      - `id` string, required
      - `data` object, required
      - `proof` object, required
      - `context` string, required
      - `type` string, required
      - `expirationDate` string
      - `issuanceDate` string, required
      - `credentialStatus` object, required
  - `meta` PaginatedMetadata, required
    - `total` integer, required
    - `page` integer, required
    - `max_results` integer, required

## Other responses

- `400`: Bad Request
- `404`: Not found
- `500`: Internal Server error

## Changes

- **2025-11-21** `1d58f0024f84`: 2 info
  - added the new optional `query` request parameter `schemaType`
  - added the new optional `query` request parameter `schemaUrl`
- **2025-10-20** `cccd00a496da`: 3 info
  - added the optional property `items/items/encryptedVC/expirationDate` to the response with the `200` status
  - added the required property `items/items/encryptedVC/credentialStatus` to the response with the `200` status
  - added the required property `items/items/encryptedVC/issuanceDate` to the response with the `200` status
- **2025-10-15** `593bd7e21102`: 1 breaking
  - the `items/items/encryptedVC/data` response's property format changed from `json` to no format for status `200`
- **2025-10-13** `1b654d2d8139`: 1 breaking
  - the `items/items/encryptedVC/data` response's property type changed from `string` to `object` for status `200`
- **2025-10-13** `04191088c904`: 1 breaking, 1 info
  - the response property `items/items/vc` became optional for the status `200`
  - added the optional property `items/items/encryptedVC` to the response with the `200` status

[Operation history](https://skmtc.dev/0xpolygonid/apis/privado-id-issuer/changes/v2/identities/:identifier/credentials/get.md)

---

[API](https://skmtc.dev/0xpolygonid/apis/privado-id-issuer.md) - [All operations](https://skmtc.dev/0xpolygonid/apis/privado-id-issuer/llms.txt) - [OpenAPI document](https://skmtc.dev/0xpolygonid/apis/privado-id-issuer/revisions/8ea65174fe46?raw)