{"command":{"effect":"read","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Gets a list of coupon codes associated with a coupon/coupons or a profile/profiles.\n\nA coupon/coupons or a profile/profiles must be provided as required filter params.<br><br>*Rate limits*:<br>Burst: `350/s`<br>Steady: `3500/m`\n\n**Scopes:**\n`coupon-codes:read`\n\n[OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/get_coupon_codes.json)","properties":{"query":{"type":"object","properties":{"fields[coupon-code]":{"type":"array","items":{"type":"string","enum":["expires_at","id","status","unique_code"]},"description":"For more information please visit https://developers.klaviyo.com/en/v2026-10-15/reference/api-overview#sparse-fieldsets"},"fields[coupon]":{"type":"array","items":{"type":"string","enum":["assigner_configuration","assigner_configuration.unused_expired","assigner_configuration.used","description","external_id","id","monitor_configuration"]},"description":"For more information please visit https://developers.klaviyo.com/en/v2026-10-15/reference/api-overview#sparse-fieldsets"},"filter":{"type":"string","examples":["equals(coupon.id,'10OFF')"],"description":"For more information please visit https://developers.klaviyo.com/en/v2026-10-15/reference/api-overview#filtering<br>Allowed field(s)/operator(s):<br>`expires_at`: `greater-or-equal`, `greater-than`, `less-or-equal`, `less-than` (date-time)<br>`status`: `equals` (allowed values: `'UNASSIGNED'`, `'PROCESSING'`, `'ASSIGNED_TO_PROFILE'`, `'VERSION_NOT_ACTIVE'`, `'DELETING'`, `'USED'`)<br>`coupon.id`: `any`, `equals` (string)<br>`profile.id`: `any`, `equals` (string)"},"include":{"type":"array","items":{"type":"string","enum":["coupon"]},"description":"For more information please visit https://developers.klaviyo.com/en/v2026-10-15/reference/api-overview#relationships"},"page[cursor]":{"type":"string","description":"For more information please visit https://developers.klaviyo.com/en/v2026-10-15/reference/api-overview#pagination"},"page[size]":{"type":"integer","default":100,"maximum":100,"minimum":1,"description":"Default: 100. Min: 1. Max: 100."}},"required":["filter"],"additionalProperties":false},"headers":{"type":"object","properties":{"revision":{"type":"string","default":"2026-10-15","enum":["2026-10-15"],"description":"API endpoint revision (format: YYYY-MM-DD[.suffix])"}},"required":["revision"],"additionalProperties":false}},"required":["query","headers"],"additionalProperties":false},"name":"Get Coupon Codes","id":"klaviyo.get_coupon_codes","example":{"query":{"filter":"equals(coupon.id,'10OFF')"},"headers":{"revision":"2026-10-15"}},"maxRequests":1,"summary":false}}