> ## Documentation Index > Fetch the complete documentation index at: https://docs.crevio.co/llms.txt > Use this file to discover all available pages before exploring further. # List discounts > Returns a list of discounts for the current account ## OpenAPI ````yaml /developer/api-reference/openapi.json get /discounts openapi: 3.1.1 info: title: Crevio API V1 version: 1.0.0 description: > API for the Crevio creator platform — a multi-tenant SaaS for digital product sales. Uses snake_case keys following Stripe conventions. All resource IDs are string IDs (e.g., "prod_abc123"). contact: email: support@crevio.co name: Crevio Support url: https://docs.crevio.co license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.crevio.co/v1 description: Production security: - ApiKey: [] tags: - name: Account description: Current account information - name: BlogCategories description: Blog post categories - name: BlogPosts description: Blog content management - name: Carts description: Shopping cart management - name: CheckoutLinks description: Shareable checkout links - name: Checkouts description: Checkout session management - name: Customers description: Customer relationship management - name: Discounts description: Discount code management - name: Emails description: Email sending - name: Experiences description: Digital experiences (courses, communities, downloads) - name: Files description: File uploads and external media management - name: FormSubmissions description: Form submission management - name: Forms - name: Invoices description: Invoice creation, payment, and lifecycle management - name: LegalPages - name: Me description: Current user profile - name: OrderItems description: Order line items - name: Orders description: Order history and details - name: PriceVariants description: Product pricing tiers - name: Products description: Digital product catalog - name: Refunds description: Refund management - name: Reviews description: Product reviews - name: Subscriptions description: Subscription lifecycle management (cancel, pause, resume) - name: Tags description: Customer tags - name: TaskRuns description: Individual execution records for AI tasks. - name: Tasks description: >- AI tasks — scheduled or event-triggered agentic work (cron, interval, once, immediate, event). - name: WebhookEndpoints description: Webhook endpoint management - name: WebhookEvents description: Webhook event delivery history - name: X402Configuration description: x402 payment protocol configuration paths: /discounts: get: tags: - Discounts summary: List discounts description: Returns a list of discounts for the current account operationId: listDiscounts parameters: - name: status in: query description: Filter by discount status schema: type: string enum: - active - expired - scheduled - name: query in: query description: Search by discount code schema: type: string - $ref: '#/components/parameters/StartingAfter' - $ref: '#/components/parameters/Limit' responses: '200': description: List of discounts content: application/json: schema: $ref: '#/components/schemas/ListResponse_Discount' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '500': $ref: '#/components/responses/InternalServerError' security: - ApiKey: [] x-codeSamples: - lang: typescript label: Typescript (SDK) source: |- import { Crevio } from "@crevio/sdk"; const crevio = new Crevio({ apiKey: process.env["CREVIO_API_KEY"] ?? "", }); async function run() { const result = await crevio.discounts.list({}); console.log(result); } run(); components: parameters: StartingAfter: name: starting_after in: query description: Cursor for pagination — the ID of the last item in the previous page schema: type: string Limit: name: limit in: query description: Items per page schema: type: integer minimum: 1 maximum: 100 default: 20 schemas: ListResponse_Discount: type: object properties: object: type: string enum: - list data: type: array items: $ref: '#/components/schemas/Discount' has_more: type: boolean url: type: string required: - object - data - has_more - url Discount: type: object properties: id: type: string object: type: string status: type: string enum: - active - inactive discount_type: type: string enum: - percentage - fixed code: type: string amount_off: type: - integer - 'null' duration: type: string enum: - forever - once - repeating duration_in_months: type: - integer - 'null' max_redemptions: type: - integer - 'null' times_redeemed: type: integer redeem_by: type: - string - 'null' format: date-time created_at: type: string format: date-time updated_at: type: string format: date-time percent_off: type: - number - 'null' format: double currency: type: - string - 'null' required: - id - object - status - discount_type - code - amount_off - duration - duration_in_months - max_redemptions - times_redeemed - redeem_by - created_at - updated_at - percent_off - currency Error: type: object properties: error: type: object properties: type: type: string enum: - api_error - invalid_request_error - validation_error code: type: string message: type: string param: type: string errors: type: object required: - type - message required: - error responses: BadRequest: description: Bad request content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: invalid_request_error code: bad_request message: The request was malformed or contained invalid parameters Unauthorized: description: Authentication required content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: invalid_request_error code: authentication_required message: You did not provide an API key. Forbidden: description: Forbidden content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: invalid_request_error code: forbidden message: You do not have permission to perform this action InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: api_error code: internal_error message: An unexpected error occurred securitySchemes: ApiKey: type: apiKey in: header name: Authorization description: 'API key in the format: Bearer {api_token}' ````