Skip to content

Coupons API

Get a coupon code bulk create job

GEThttps://email.growthdept.ai/api/coupon-code-bulk-create-jobs/{job_id}

Rate limits

Burst: 75/s

Steady: 750/m

Tier L. See rate limits for how requests are counted.

Scopes

coupon-codes:read

Operation id

get_bulk_create_coupon_codes_job The same operation as in Klaviyo's API. OpenAPI document

Path parameters

stringrequired

Query parameters

array of strings

Attributes of coupon-code-bulk-create-job resources to return.

Sparse fieldsets guide

Pick values to add them to the request:

array of strings

Attributes of coupon-code resources to return.

Sparse fieldsets guide

Pick values to add them to the request:

array of strings

Related resources to side-load.

Includes guide

Pick values to add them to the request:

Headers

stringrequireddefault 2026-10-15

API revision, YYYY-MM-DD. This server implements 2026-10-15.

Revisions guide

Responses

200Success

Response body

object

  • dataobjectrequired

    data: 5 fields
    • typestringrequired

      coupon-code-bulk-create-job
    • idstringrequired

    • attributesobjectrequired

      attributes: 8 fields
      • statusstringrequired

        cancelledcompleteprocessingqueued
      • created_atstring (date-time)required

      • total_countintegerrequired

      • completed_countintegercan be null

      • failed_countintegercan be null

      • completed_atstring (date-time)can be null

      • errorsarray of objectscan be null

        errors: 5 fields
        • idstringrequired

        • codestringrequired

        • titlestringrequired

        • detailstringrequired

        • sourceobjectrequired

          source: 1 field
          • pointerstringcan be null

      • expires_atstring (date-time)can be null

    • relationshipsobject

      relationships: 1 field
      • coupon-codesobject

        coupon-codes: 2 fields
        • dataarray of objects

          data: 2 fields
          • typestringrequired

            coupon-code
          • idstringrequired

        • linksobject

          links: 2 fields
          • selfstring (uri)required

          • relatedstring (uri)required

    • linksobjectrequired

      links: 1 field
      • selfstring (uri)required

  • includedarray of objects

    included: 5 fields
    • typestringrequired

      coupon-code
    • idstringrequired

    • attributesobjectrequired

      attributes: 3 fields
      • unique_codestringcan be null

      • expires_atstring (date-time)can be null

      • statusstringcan be null

        ASSIGNED_TO_PROFILEDELETINGPROCESSINGUNASSIGNEDUSEDVERSION_NOT_ACTIVE
    • relationshipsobject

      relationships: 2 fields
      • couponobject

        coupon: 2 fields
        • dataobject

          data: 2 fields
          • typestringrequired

            coupon
          • idstringrequired

        • linksobject

          links: 2 fields
          • selfstring (uri)required

          • relatedstring (uri)required

      • profileobject

        profile: 2 fields
        • dataobject

          data: 2 fields
          • typestringrequired

            profile
          • idstringrequired

        • linksobject

          links: 2 fields
          • selfstring (uri)required

          • relatedstring (uri)required

    • linksobjectrequired

      links: 1 field
      • selfstring (uri)required

  • linksobject

    links: 1 field
    • selfstring (uri)required

  • metaobject

4XXClient error

Response body

object

  • errorsarray of objectsrequired

    errors: 8 fields
    • idstringrequired

    • statusintegerrequired

    • codestringrequired

    • titlestringrequired

    • detailstringrequired

    • sourceobject

      source: 2 fields
      • pointerstring

      • parameterstring

    • linksobject

    • metaobject

See status codes for each code.

5XXServer error

Response body

object

  • errorsarray of objectsrequired

    errors: 8 fields
    • idstringrequired

    • statusintegerrequired

    • codestringrequired

    • titlestringrequired

    • detailstringrequired

    • sourceobject

      source: 2 fields
      • pointerstring

      • parameterstring

    • linksobject

    • metaobject