---
title: "GET /api/v3.3/promo-codes"
method: GET
path: "/api/v3.3/promo-codes"
tags: ["PromoCodes"]
---

# GET /api/v3.3/promo-codes

`GET /api/v3.3/promo-codes`

Fetches promo codes by provided filter

## Query parameters

- `propertiesUids` string[]
- `statuses` string[]
- `from` string
- `to` string
- `sort` 'SORT_BY_CODE' | 'SORT_BY_STATUS' | 'SORT_BY_TYPE' | 'SORT_BY_VALUE' | 'SORT_BY_CURRENCY' | 'SORT_BY_SINGLE_USAGE' | 'SORT_BY_VALID_FROM_DATE_TIME' | 'SORT_BY_VALID_TO_DATE_TIME' | 'SORT_BY_EXPIRATION_DATE_TIME' | 'SORT_BY_CREATED_DATE'
- `sortDirection` 'ASC' | 'DESC'
- `_cursor` string — Cursor for pagination
- `_limit` string — Limit for pagination

## Response `200`

OK

- PromoCodeResponseWrapper
  - `promoCodes` PromoCodeApi3Dto[]
    - `uid` string
    - `code` string
    - `status` 'ACTIVE' | 'EXPIRED' | 'REDEEMED' | 'DELETED'
    - `type` 'AMOUNT' | 'PERCENT'
    - `value` number
    - `currency` 'AED' | 'ARS' | 'AUD' | 'BGN' | 'BHD' | 'BRL' | 'CAD' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CZK' | 'DKK' | 'DOP' | 'EUR' | 'GBP' | 'GTQ' | 'HKD' | 'HUF' | 'IDR' | 'IKR' | 'ILS' | 'INR' | 'JPY' | 'KES' | 'KRW' | 'MXN' | 'MYR' | 'NOK' | 'NONE' | 'NZD' | 'PEN' | 'PHP' | 'PLN' | 'RON' | 'RUB' | 'SEK' | 'SGD' | 'THB' | 'TRY' | 'TWD' | 'USD' | 'UYU' | 'VEF' | 'VND' | 'VUV' | 'JOD' | 'SAR' | 'EGP' | 'ZAR' | 'TTD' | 'BBD' | 'CVE' | 'AWG' | 'MAD' | 'PYG'
    - `singleUsage` boolean
    - `validFromZonedDateTime` string, date-time
    - `validToZonedDateTime` string, date-time
    - `expirationZonedDateTime` string, date-time
    - `validFromUTCDateTime` string
    - `validToUTCDateTime` string
    - `expirationUTCDateTime` string
    - `propertyUid` string
    - `agencyUid` string
  - `_metadata` Api3ResponseMetadata
    - `count` integer
    - `totalCount` integer
  - `_paging` Api3ResponsePaging
    - `_limit` integer
    - `_nextCursor` string

---

[API](https://skmtc.dev/hostfully/apis/hostfully-api.md) · [All operations](https://skmtc.dev/hostfully/apis/hostfully-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hostfully/hostfully-api/revisions/8387ad22afc6/schema)