---
title: "Get Recommendations by Identity Value"
method: GET
path: "/wallet/recommendations"
tags: ["Recommendations"]
---

# Get Recommendations by Identity Value

`GET /wallet/recommendations`

This API method allows the calling application to retrieve of recommendations linked to the identity value given in the request. The validity of the identity value is not checked in this request.

## Query parameters

- `identity-value` string, string, required
- `status` string, string, required
- `channel` string, string, required

## Response `200`

OK

- RecommendationEntity[]
  - `guid` string, string, required — the unique reference for this file
  - `catalogue` string, string — the unique reference for this file
  - `subject` string[] — the unique reference for this file
  - `target` string[]
  - `validFrom` string, string — ATOM formatted date time for the valid from
  - `validTo` string, string, required — ATOM formatted date time for the valid from
  - `channel` string[]
  - `weight` number — the weight of this recommendation
  - `status` 'ACTIVE' | 'ACCEPTED' | 'REJECTED' | 'DELETED', required — The Catalogue status
  - `meta` MetaEntity
    - `key1` string — Meta 1 property, up to 250 characters; up to 750 characters for Key 1 Value
    - `key2` string — Meta 2 property, up to 250 characters; up to 750 characters for Key 2 Value
  - `data` object
  - `dateCreated` string, string, required — the date the record was created
  - `lastUpdated` string, string, required — the date the record was last updated

## Other responses

- `401` — Unauthorized.
- `403` — Forbidden.
- `415` — Unsupported Media Type
- `423` — Locked
- `429` — Too Many Requests
- `500` — Server Error

---

[API](https://skmtc.net/eagleeye/apis/wallet-api.md) · [All operations](https://skmtc.net/eagleeye/apis/wallet-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eagleeye/wallet-api/revisions/90a122bb14cc/schema)