> ## Documentation Index > Fetch the complete documentation index at: https://docs.salesbricks.com/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve a discount coupon > Returns the details of a specific discount coupon by its code. The code lookup is case-insensitive. The response includes the coupon's current status (`active`, `is_valid`, `is_expired`) so the caller can determine how to handle it. Use this endpoint to validate and display coupon details during checkout. ## OpenAPI ````yaml https://api.salesbricks.com/api/v2/openapi.yaml get /discount-coupons/{code} openapi: 3.0.3 info: title: Salesbricks REST API version: 2.0.0 description: API reference for external integrations servers: - url: https://api.salesbricks.com/api/v2 description: Production - url: https://api.staging.salesbricks.com/api/v2 description: Staging security: - ApiKeyAuth: [] tags: - name: Subscriptions description: >- Operations related to subscription management, including creation, updates, and retrieving subscription details. Subscriptions can be upgraded to add / remove add-ons by using the POST /subscriptions/{subscription_id}/upgrade endpoint and can be recasted for replacing the current agreement using the POST /subscriptions/{subscription_id}/recast endpoint - name: Customers description: >- Operations related to customer management, including creation, updates, and managing customer person objects. - name: Invoices description: Operations related to subscription's invoicing details. - name: Plans description: >- Operations related to listing and getting plan details including bricks in the plan. - name: Payment Methods description: Operations related to subscription's payment method. paths: /discount-coupons/{code}: get: tags: - Discount Coupons summary: Retrieve a discount coupon description: >- Returns the details of a specific discount coupon by its code. The code lookup is case-insensitive. The response includes the coupon's current status (`active`, `is_valid`, `is_expired`) so the caller can determine how to handle it. Use this endpoint to validate and display coupon details during checkout. operationId: retrieveDiscountCoupon parameters: - in: path name: code schema: type: string description: The coupon code to retrieve (case-insensitive) required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/DiscountCoupon' description: '' '404': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: NotFoundResponse: value: error: code: ERR_NOT_FOUND message: >- Not found — the resource you are looking for does not exist. summary: Not Found Response description: '' components: schemas: DiscountCoupon: type: object description: Serializer for discount coupon information. properties: code: type: string readOnly: true description: Unique coupon code used to redeem this discount name: type: string readOnly: true description: Display name for the coupon description: type: string readOnly: true description: Description of what this coupon provides expires_at: type: string format: date-time readOnly: true nullable: true description: When this coupon expires (null means no expiration) discount_type: type: string readOnly: true description: >- The type of discount this coupon provides. Only duration discount is supported for now. discount_rate: type: string format: decimal pattern: ^-?\d{0,14}(?:\.\d{0,6})?$ readOnly: true nullable: true description: Percentage discount rate applied for the duration period duration_months: type: integer readOnly: true nullable: true description: Number of months the duration discount applies (999 means forever) active: type: boolean readOnly: true description: Whether this coupon is currently active and can be used is_expired: type: boolean readOnly: true description: Whether this coupon has expired eligible_brick_ids: type: array items: type: string format: uuid readOnly: true description: >- Brick IDs this coupon's discount applies to. Empty means all bricks. Only present for duration coupons. required: - active - code - description - discount_rate - discount_type - duration_months - eligible_brick_ids - expires_at - is_expired - name ErrorResponse: type: object description: >- Standardizes API error responses with a consistent structure containing error code and message. properties: error: $ref: '#/components/schemas/Error' required: - error Error: type: object description: >- Represents individual error details with a standardized code and descriptive message. properties: code: enum: - ERR_NOT_FOUND - ERR_BAD_REQUEST - ERR_SERVER_ERROR type: string x-spec-enum-id: dc5a5d6feae1b697 description: >- Error code indicating the type of error: NOT_FOUND for missing resources, BAD_REQUEST for invalid input, SERVER_ERROR for internal server issues * `ERR_NOT_FOUND` - ERR_NOT_FOUND * `ERR_BAD_REQUEST` - ERR_BAD_REQUEST * `ERR_SERVER_ERROR` - ERR_SERVER_ERROR message: type: string error_id: type: string format: uuid description: >- Correlation handle for SERVER_ERROR responses — quote this when contacting support; it joins to the structured server log line for the failure. Not present on 4xx responses. required: - code - message securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-SALESBRICKS-KEY description: API key for authentication ```` ## Related topics - [MCP](/integrations/mcp.md) - [Overview](/api-reference/getting-started/overview.md) - [Duration Discounts](/orders/duration-discounts.md)