Get Offers By User

curl -G https://rewards-api.getkard.com/v2/issuers/organization-123/users/user-123/offers \
     -H "Authorization: Bearer <token>" \
     -d "page[size]=1" \
     -d "filter[isTargeted]=true" \
     -d sort=-startDate

{
  "data": [
    {
      "type": "standardOffer",
      "attributes": {
        "assets": [
          {
            "type": "IMG_VIEW",
            "url": "http://assets.getkard.com/logo/img?attribution-tokens",
            "alt": "Worlds Greatest Chicken Logo Image"
          },
          {
            "type": "BANNER_VIEW",
            "url": "http://assets.getkard.com/banner/img?attribution-tokens",
            "alt": "Worlds Greatest Chicken Banner Image"
          }
        ],
        "expirationDate": "2025-03-17T05:00:00Z",
        "isTargeted": true,
        "name": "Worlds Greatest Chicken",
        "purchaseChannel": [
          "INSTORE"
        ],
        "startDate": "2024-11-17T05:00:00Z",
        "terms": "Worlds Greatest Chicken offers are only available within US Locations.",
        "userReward": {
          "type": "PERCENT",
          "value": 5.7
        },
        "description": "Worlds Greatest Chicken brings you the tastiest crispy, double fried spicy chicken in the world.",
        "maxRedemptions": 1,
        "maxRewardAmount": {
          "type": "CENTS",
          "value": 2000
        },
        "maxTransactionAmount": {
          "type": "CENTS",
          "value": 10000
        },
        "minRewardAmount": {
          "type": "CENTS",
          "value": 500
        },
        "minTransactionAmount": {
          "type": "CENTS",
          "value": 500
        },
        "websiteUrl": "http://worldsgreatestchickent.test.com"
      },
      "id": "5e27318c9b346f00087fbb5c",
      "relationships": {
        "category": {
          "data": [
            {
              "type": "category",
              "id": "65920081b524d126068de24a"
            },
            {
              "type": "category",
              "id": "65920081b524d126068de24c"
            }
          ]
        }
      }
    }
  ],
  "links": {
    "self": "/v2/issuers/{organizationId}/users/{userId}/offers?page[size]=1?sort=-startDate",
    "prev": null,
    "next": "/v2/issuers/{organizationId}/users/{userId}/offers?page[after]=NDMyNzQyODI3OTQw&page[size]=1?&sort=-startDate"
  },
  "included": [
    {
      "type": "category",
      "id": "65920081b524d126068de24a",
      "attributes": {
        "name": "Food & Beverage"
      }
    },
    {
      "type": "category",
      "id": "65920081b524d126068de24c",
      "attributes": {
        "name": "Department Stores"
      }
    }
  ]
}

Retrieve national brand offers that a specified user is eligible for. Call this endpoint to build out your targeted offers UX experience. Local offers details can be found by calling the Get Eligible Locations.
Required scopes: rewards:read

Retrieve national brand offers that a specified user is eligible for. Call this endpoint to build out your [targeted offers UX experience](/2024-10-01/api/getting-started#b-discover-a-lapsed-customer-clo). Local offers details can be found by calling the [Get Eligible Locations](/2024-10-01/api/rewards/locations).<br/> <b>Required scopes:</b> `rewards:read`

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

organizationIdstringRequired

Your issuer organization ID, provided by Kard

userIdstringRequired

The ID of the user as defined on the issuers system

Query parameters

page[size]integerOptional

page[after]stringOptional

page[before]stringOptional

filter[purchaseChannel]list of enumsOptional

Allowed values:

filter[category]enumOptional

Category of merchant. Please use URL Encode for non single word categories. (Food & Beverage should be Food%20%26%20Beverage)

filter[isTargeted]booleanOptional

sortenumOptional

If provided, response will be sorted by the specified fields

includestringOptional

CSV list of included resources in the response (e.g “categories”). Allowed value is categories.

supportedComponentsenumOptional

UI component types to include in the response. Valid values are shortDescription, longDescription, cta, tags, and detailTags.

Allowed values:

Response

This endpoint returns an object.

datalist of objects

linksobject

Authentication

Path parameters

Query parameters

Response

Errors