---
title: "Get user gift cards"
method: GET
path: "/user/loyalty/certificates"
tags: ["Client Personal Cabinet"]
---

# Get user gift cards

`GET /user/loyalty/certificates`

## Request

- Base URL: `https://api.alteg.io/api/v1`
- URL: `https://api.alteg.io/api/v1/user/loyalty/certificates`
- Auth: HTTP bearer

Returns a list of authorized user gift cards

## Query parameters

- `location_id` number, required

## Headers

- `Accept` string, required
- `Content-Type` string, required
- `Authorization` string, required

## Response `200`

OK

- LoyaltyCertificatesResponseDataTypes: Get gift cards
  - `success` boolean: Execution success status (true)
  - `data` object[]: Array of objects with data
    - `id` integer: Gift Card ID
    - `number` string: Gift card number
    - `balance` number, float: Current balance
    - `default_balance` number, float: Starting balance
    - `type_id` integer: Gift card type identifier
    - `status_id` integer: Status ID
    - `created_date` string, date-time: Date of sale
    - `expiration_date` string, date-time: Burn date
    - `type` object: Object with gift card type information
      - `id` integer: Gift card type identifier
      - `title` string: Gift card type name
      - `balance` integer: Gift card denomination
      - `is_multi` boolean: Is it available for multiple debits
      - `company_group_id` integer: ID of the chain where the gift card type was created
      - `item_type_id` integer: Restriction on the use of redemption points. 0 - no restrictions, 1 - only services, 2 - some services + all products, 3 - some services, 4 - only products
      - `expiration_type_id` integer: The ID of the expiration limit. 0 - unlimited, 1 - fixed date, 2 - fixed period
      - `expiration_date` string, date-time: Burn date of all gift cards. Populated with expiration_type_id = 1
      - `expiration_timeout` integer: Validity period of gift cards. Populated with expiration_type_id = 2
      - `expiration_timeout_unit_id` integer: Time units. 1 - Day, 2 - Week, 3 - Month, 4 - Year
      - `is_allow_empty_code` boolean: Sale without code
      - `item_type` object: Object with item_type_id and its name
        - `id` integer: Identifier of the expiration limit
        - `title` string: Name of the constraint
    - `status` object: An object with information about the current status of the gift card
      - `id` integer: Status ID
      - `title` string: Status name
  - `meta` object: Metadata (contains the number of gift cards found)
    - `count` integer

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

## Changes

- **2026-10-22** `84ccb2a8d759`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/alteg/apis/online-booking/changes/user/loyalty/certificates/get.md)

---

[API](https://skmtc.dev/alteg/apis/online-booking.md) - [All operations](https://skmtc.dev/alteg/apis/online-booking/llms.txt) - [OpenAPI document](https://skmtc.dev/alteg/apis/online-booking/revisions/5219afc665ea?raw)
