How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Aghanim Coupons API

The Coupons API from Aghanim — 3 operation(s) for coupons.

Aghanim Coupons API is one of 27 APIs that Aghanim publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Coupons. The published artifact set on APIs.io includes an OpenAPI specification and authentication docs.

This API exposes 7 operations across 3 paths, and defines 33 schemas. It is described by OpenAPI 3.2.0, at version 2026.07.14.

Requests are made against a single base URL, https://api.aghanim.com/s2s.

7 operations 3 paths 33 schemas 1 DELETE3 GET1 PATCH1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2026.07.14
Base URL
https://api.aghanim.com/s2s
Authentication
HTTP Bearer
Contact
Resource Areas
1

Authentication & Security 1

Aghanim Coupons API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (HTTPBearer).

  • HTTPBearer — Refer to the [Authentication](https://docs.aghanim.com/api-reference/) section for instructions on obtaining an API key and use it as the Bearer token.

Paths & Operations 7

Across 3 paths, the API surfaces 7 operations — 1 DELETE, 3 GET, 1 PATCH, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Coupons 7
GET
/v1/coupons/user/{user_id}
Get User Coupons
get_user_coupons 3 params → 200422
GET
/v1/coupons
Get Coupons
get_coupons 6 params → 200422
POST
/v1/coupons
Create Coupon
create_coupon body → 201422
PATCH
/v1/coupons
Bulk Update Coupon
bulk_update_coupon body → 200422
GET
/v1/coupons/{coupon_id}
Get Coupon
get_coupon 1 param → 200422
PUT
/v1/coupons/{coupon_id}
Update Coupon
update_coupon 1 param body → 200422
DELETE
/v1/coupons/{coupon_id}
Delete Coupon
delete_coupon 1 param → 204422

Schemas 33

The contract defines 33 schemas that model the data the API accepts and returns. The most detailed are ItemRead (51 properties), UserCouponRead (31 properties), CouponRead (29 properties), CouponCreate (26 properties). Each schema is shown below with its type and property counts.

Currency
string
HTTPValidationError
object
1 property
CreatorProgramUpdate
object
4 properties
ItemPropertyRelationRead
object
6 properties 5 required
ItemType
string
An enumeration.
NestedItem
object
7 properties
CouponGeneratedType
string
An enumeration.
ItemPropertyConfigRange
object
3 properties 1 required
Expression
object
2 properties
TokenType
string
ItemRarityRead
object
3 properties 2 required
ItemPropertyRelationData
object
1 property
ItemViewOption
string
An enumeration.
MathExpression
object
2 properties 1 required
CouponType
string
An enumeration.
ValidationError
object
3 properties 3 required
CouponCreate
object
26 properties 3 required
ItemPropertyConfigString
object
1 property
Token
object
2 properties 1 required
HighlightItem
object
3 properties
CouponFreeItem
object
2 properties 2 required
CouponRead
object
29 properties 4 required
ItemPropertyConfigNumber
object
1 property
CouponBulkUpdate
object
2 properties 2 required
CouponFreeItems
object
API wrapper for the freeitems JSONB column, mirroring the storage shape.
1 property
ItemRead
object
51 properties 8 required
UserCouponRead
object
31 properties 4 required
Highlights
object
3 properties 1 required
ItemPropertyRead
object
5 properties 3 required
ItemSource
string
An enumeration.
CouponUpdate
object
24 properties
CreatorProgramBase
object
5 properties 4 required
NestedItemViewType
string
An enumeration.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

aghanim-coupons-api-openapi.yml Raw ↑

Other APIs Aghanim publishes across the network.

Aghanim Achievements API
Aghanim Creators API
Aghanim Daily Rewards API
Aghanim GDPR Requests API
Aghanim Item Categories API
Aghanim Items API
Aghanim Leaderboards API
Aghanim LiveOps API
Aghanim Locales API
Aghanim Loyalty Program API
Aghanim News API
Aghanim Orders API
Where this information came from

This is an independent, third-party profile of Aghanim Coupons API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.